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PER ESPERTI E PRINCIPIANTI 




CAMERA 

IMPARA A PROGRAMMARE LA CAM 
\ DEL CELLULARE E CREA UHI BLOG 
\ FOTOGRAFICO SU IIUTERIUET 



Gestisci la fotocamera 
con una tua applicazione 

Salva le immagini e i video 
all'interno del telefono 

Crea un servizio sul web 
pronto a ricevere le foto 



HACKING DI SISTEMA 

Prendi il controllo di Windows intercettando 
gli eventi e riprogrammandoli con un hook 



VIDEOGAMING 





Sfrutta al massimo l'hardware dei PC e crea 
giochi superveloci con Vertex Shader e DirectX 



VISUAL BASIC 



FAI PARLARE IL PC 

Ecco come creare software 
moderno capace di supportare 
gli utenti tramite la voce 




INTEL C++ COMPILER 

La guida per utilizzare al 
meglio la potenza di calcolo di 
un compilatore ottimizzato 
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IOPROGRAMMO WEB 



QUANDO PHP 
INCONTRA JAVA 

Impara come riutilizzare il 
tuo lavoro inserendo classi 
Java nelle pagine PHP 



C# & VB.NET 



EXCEL & C# 
COPPIA VINCENTE 

Usa tutta la potenza di 
.NET per rielaborare i dati 
di un foglio elettronico 

NON SIAMO SOLI: 
REMOTING .NET 

Metti in comunicazione 
i software e crea 
applicazioni distribuite 

TUTTI PRONTI 
PER MONO 

Crea programmi in C#, che 
funzionano sia con Linux 
sia con Windows 



JAVA 



GESTIRE LA POSTA 
ELETTRONICA 

Sfrutta JavaMail per spedire 
e ricevere la posta 
direttamente da Java 

INTERFACCE : CON 
XML SI PUÒ!!! 

Alla scoperta di Thinlet, una 
libreria per definire il layout 
usando XML 

ACCESSO Al DB 
FACILE CON JDBC 

Elimina ogni problema sui 
database, imparando come 
usarli semplicemente 
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KERNEL: COME RISOLVERE I 
PROBLEMI DEL MULTITASKING 
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T Uno sguardo avanti 



XML, soap, web services, 
programmazione internet oriented, 
applicazioni dedicate ad ogni tipo di 
mercato e soluzioni sperimentate per ogni 
tipo di device, negli ultimi anni le 
abbiamo provate tutte per far uscire il 
mercato da una stasi che tende a 
diventare cronica. Pur scontrandoci con le 
diffidenze di amministratori un po' troppo 
tradizionalisti, pur facendo i conti con 
clienti ancorati a vecchi modi di concepire 
la gestione aziendale, noi programmatori 
siamo riusciti in un modo o nell'altro ad 
evolvere e a fare evolvere questa vecchia 
Europa nella direzione del progresso. E 
non credo di essere presuntuoso nel dire 
che chi, come noi, come voi, fa ricerca e 
sviluppo non sia una parte importante del 
propulsore che spinge verso una qualità 



della vita migliore. E adesso? adesso che in 
campo software quasi tutto è stato 
inventato, riusciremo ancora a trovare 
nuovi canali dove spingere la nostra 
curiosità? Come sempre, un nuovo settore, 
sembra nascere da un evento 
esclusivamente commerciale: 
l'acquisizione di Macromedia da parte di 
Adobe. Questa acquisizione vuol dire una 
sola cosa, ovvero che il mondo della 
grafica può considerarsi saldamente nelle 
mani di un grande colosso. Questo per 
noi vuol dire standard, vuol dire per noi 
possibilità di sviluppare plugin, 
applicazioni, estensioni, formati, dedicati 
al mondo della grafica. Che sia questa una 
delle tante nuove frontiere che ci 
attendono? 

Fabio Farnesi 




U CD IJ WEB 

nome_file.zip 



All'inizio di ogni articolo, troverete un simbolo che indicherà la presenza di 

codice e/o software allegato, che saranno presenti sia sul CD (nella posizione 

di sempre \soft\codice\ e \soft\tools\) sia sul Web, all'indirizzo 

http://cdrom.ioprogrammo.it. 

Per scaricare software e codice da Internet, ogni mese indicheremo una 

password differente. Per il numero che avete fra le mani la combinazione è: 



Username: micio74 



Password: rumors82 



MOBILE 
CAMERA 

Impara a programmare la cam 
del tuo cellulare e crea un blog 
fotografico sul web 



Prendi il controllo 
della fotocamera 

Salva le foto 

e il video sul cellulare 

Crea un servizio web 
pronto a ricevere le f 
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VIDEOGAMING 

Sfrutta al massimo l'hardware del PC 
con il vertex shader e le directx 



QUANDO PHP 
INCONTRA JAVA pag .20 

L'idea è molto semplice: utilizzare 
le classi java da script PHP. 



SISTEMA 



Creare interfacce Java con XML pag. 24 

Un metodo interessante per separare la logica 
dell'interfaccia da quella dell'applicazione. 

Amici per la pelle thread 

e interfacce pag. 28 

Come evitare che le interfacce grafiche risultino 
rallentate da applicazioni non ottimizzate 

Mono un ponte fra Windows 

e Linux pag. 32 

Programmare utilizzando .NET e C# anche 
in ambiente Linux. 

Microsoft .NET Remoting - software 
che comunicano pag. 36 

Come creare host e invocare oggetti remoti da 
codice senza l'uso di file di configurazione. 

Excel per motore C# 

per pilota pag. 42 

Impareremo ad usare un foglio di lavoro di 
Excel attraverso un software scritto in C#. 



GRAFICA 



Due trucchi per migliorare 

VB.NET pag. 50 

List View e Tree View, controlli molto potenti e 
comodi, tranne che per qualche limitazione. 
Vediamo come personalizzarli 
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Gli allegati di ioProgrammo 

// software in allegato alla rivista 



pag. 6 



News pag. 8 

Le più importanti novità del mondo della program- 
mazione 

La posta dei lettori pag. 10 

L'esperto risponde ai vostri quesiti 

Il meglio dei newsgroup pag. 12 

ioProgrammo raccoglie per voi le discussioni 
più interessanti della rete 



Java e JDBC per l'accesso 

ai dati pag. 54 

Alla scoperta delle tecniche per utilizzare i da- 
tabase senza problemi. Poche righe di codice 
per ottenere un accesso universale 



VISUAL BASIC 



Vocal Visual Basic pag . si 

Se in altri ambienti realizzare 
applicazioni che usano la sintesi 
vocale può sembrare complesso, 
in VB questa tecnica è ormai 
decisamente consolidata. 



ADVANCED EDITION 



Gli hook di Windows in .NET. . pag. 66 

Ci avventuriamo nei meandri del sistema ope- 
rativo, per fare la conoscenza dei meccanismi 
che regolano gli eventi di sistema 



BACKSTAGE 



Liste di blocco antispam pag. 72 

In questo articolo verrà descritto il concetto di 
black list e nverranno illustrate le principali 
presenti su Internet 



MOBILE 



Intel C++ Compiler 

Un mostro di velocità pag . 76 

Dentro il compilatore Intel, che 
genera un assembly talmente 
ottimizzato da ottenere prestazioni 
100 volte superiori al normale. 



Tips & Tricks pag. 104 

Trucchi per risolvere i problemi più comuni 

Express pag. 106 

Le guide passo passo per realizzare applicazioni 
senza problemi 

Software pag. 114 

/ contenuti del CD allegato ad ioProgrammo. 
Corredati spesso di tutoria! e guida all'uso 



Biblioteca 

/ migliori testi scelti dalla redazione 



pag. 130 




pag. 46 



MOBILE 



JavaMail API pag. 82 

te classi base offerte da questo package, che 
permette di dialogare con i server SMTP, POP3 
e IMAP4 



CORSI 



Visual Basic • Fare collezione 

di Oggetti pag. 86 

Come manipolare insiemi omogenei di struttu- 
re utilizzando VB.NET. 

Asp.NET • Costruire user control pag. 92 

/ custom control consentono di creare oggetti 
che favoriscono il riutilizzo del codice . 

Javascript • L'URL che non ti fa 
arrabbiare pag. 96 

Utilizzare gli URL: l'unico metodo per scrivere 
applicazioni WEB funzionali! 

Symbian • Gestire i contatti 

con Symbian OS pag. 100 

Cellulari: ecco come vengono gestite 
le applicazioni standard 



SOLUZIONI 



Sezioni critiche pag. 126 

Fork,join, cobegin e coend, per l'attuazione 
della programmazione concorrente 



ioProgrammo cerca articolisti freelance 
competenti nei seguenti argomenti: 

Javascript Python, Perl, 

ASP.NET, PHP, Flash, 

Security 

Inviare curriculum dettagliato a 
ioProqrammo@edmaster.it 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di essere 
comprensibili a tutti coloro che ci 
seguono. Nel caso in cui abbiate 
difficoltà nel comprendere esattamente 
il senso di una spiegazione tecnica, è 
utile aprire il codice allegato all'articolo 
e seguire passo passo quanto viene 
spiegato tenendo d'occhio l'intero 
progetto. Spesso per questioni di spazio 
non possiamo inserire il codice nella sua 
interezza nel corpo dell'articolo. Ci 
limitiamo a inserire le parti necessarie 
alla stretta comprensione della tecnica. 
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ROGRAMMO 
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MOBIL! 

CAMERA 

IMPARA A PROGRAMMARE LA CAM 
DEL CELLULARE E CREA UN BLOG 
FOTOGRAFICO SU INTERNET 

■ Gestisci la fotocamera 
con una tua applicazione 

■ Salva le immagini e i video 
all'interno del telefono 

■ Crea un servizio sul web 
pronto a ricevere le foto 

HACKING DI SISTEMA 

.Prendi il controllo di Windows intercettando 
' ~ tyenti e riprogrammandoli con un hook 



QUANDO PHP,. 
INCONTRA JAVA 



-a nelle pagine PHP 



EXCEL & C# 

COPPIA VINCENTE 

Usa tutta la potenza di 
.NET per lielabotaiei dati 

NON SIAMO SOLI: 
REMOTING NET 

Metti in comunicazione 
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«are dei PC e crea 
X Shader e DirectX 
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INTEL C++ COWIPILER 

La guida per utilizzare al 
meglio la potenza di calcolo di 
un compilatore ottimizzato 



ME RISOLVERE I 
, DEL MULTITASKING 



Isoftw 

applica 

TUTTI PRONTI 
PER MONO 

Crea programmi in L», aie 
sia con Windows 



GESTIRE LA POSTA 
ELETTRONICA J 

Sfrutta JavaMail per spedire 
direttamente da Java 

INTERFACCE: CON 
XML SI PUÒ!! ! 

Alla scoperta din l'in •>!, uria 
libreria per definire il layout 
usando XML 

ACCESSO Al DB 

FACILE CON JDBC 

Elimina ogni problema sui 
database, imparando come 
limi ìoniolicemertte 



RIVISTA + CD-ROM 

in edicola 



IL SOFTWARE DEL MESE 



Questo mese ioProgrammo 
vi regala GFI: Network 
Server Monitor 6 con 
licenza completa per tre 
server. Un omaggio 
del valore di 21 5 € 



GFI Network Server 
Monitor 6 è un software 
per il monitoring 
del corretto 

funzionamento dei server 
che forniscono servizi 
alla rete aziendale. 
È possibile controllare 
sia sistemi Windows 
che Linux e praticamente 
l'intera gamma dei servizi 
disponibili, dal Web 
Server al Mail Server, 
file Server e tutti gli altri 
servizi tipici 
di unambiente di rete. 




I contenuti 
del CD-Rom 



Apache 1.3.33/2.0.53 

Il Web Server più usato 

Directory: /Apache 

Python 2.4.1. 

Il linguaggio emergente 

Directory: /Python 

Ultimate ++ 

L'IDE più innovativo per C++ 

Directory: /Ultimatepp 

Lazarus 0.9.6 

Il done Freeware di Delphi 

Directory: /lazarus 

Tomcat 5.5.9 

L'application Server per JSP 

Directory: Directory /Tomcat 

Eclipse 3.0.2 

Il più innovativo del 
momento 

Directory: Directory /Eclipse 

DevCPP 4.9.9.2 

l'ambiente più usato in C++ 

Directory: Directory: /DevCPP 

PHP 5.0.4 

Il linguaggio per il Web 

Directory: Directory /PHP 

SharpDevelop 1.0.3 

L'alternativo per C# 

Directory /SharpDevelop 

J2SE 1.5.0.2 

Indispensabile per Java 

Directory /J2SE 

DevPHP 

Leggerissimo per PHP 

Directory /DevPHP 

Dadabik3.2 

Un creatore di interfacce 

Directory: /DadaBik 

Mysql 4.1.11 -Beta 5.0.3 

Il DB server di riferimento 

Directory: MySQL 

Firebird 1.5 

Un db multipiattaforma 

Directory: /Firebird 

Hibernate 3.0 

Per la persistenza dei dati 

Directory: /Hibernate 

Jasper Reports 0.6 

Per creare reports in Java 

Directory /Jasperreports 

Snippet Compi Ver 2 

Compila un pezzo di codice 

Directory: /SnippetCompiler 

Notepad++ 2.9 

Editor per sviluppatori 

Directory: /Notepad 

Ndoc 

Per creare codice documentato 

Directory: /Ndoc 



Nant 

L'assemblatore di progetti 

Directory /nant 

Nunit 

Il costruttore di test 

Directory /nunit 

SysLinux 3.0.7 

Installare sotto linux 

Directory /SysLinux 

Regulator 2.0.3 

No problem con le regular 
expression 

Directory /Regulator 

Eclipse Visual Editor 

Per rendere Eclipse RAD 

Directory /Visual Editor 

SuperEdi3.7 

Un editor piccolo e funzio- 
nale 

Directory /Su peredi 

Spe 0.7.3 

L'editor per Python 

Directory /SpeEditor 

wxWidgets 2.4.2 

Per lo sviluppo di interfacce 

Directory: /WxWidgets 

EasyPHP 1.8 

Per installare un server PHP 

Directory /EasyPHP 

Mono 1.6.0 

.NET su tutte le piattafor- 
meforme 

Directory: /Mono 

PHPEclipse 1.1.3 

Per usare Eclipse con PHP 

Directory /PHPEclipse 

WinMerge 2 2.2 

Mai più versioni di codice 

differenti 

Directory /WinMerge 

J2MEPolish 

Il costruttore di GUI per 
device mobile 

Directory /J2MEPolish 

Installerò 

Un sistema per realizzare 
pacchetti di installazione 

Directory /lnstaller2Go 

Jedit4.2 

L'editor leggero per pro- 
grammatori Java 

Directory /Jedit 

XAMPP fot Windows 
1.4.13 

ServerWeb, FTP, DBMS, PHP 
e Perl tutto in uno 

Directory: /Xampp 

EMF 

Eclipse Modeling 
Framework 

Directory: EMF 



PHP Java Bridge 

Il ponte fra Java e PHP 

Directory /PHPJavaBridge 

PHPGroupware 0.9. 16 

Directory /PHPGroupware 

PHTML Encoder 3.8 
Per criptare le vostre 
pagine PHP 

Directory /PHTMLEncoder 

Mrtg2.11 

Per tenere sotto controllo il 
consumo delle risorse 

mrtg 

Mantis0.19 

Ottima soluzione per la 
gestione dei Bug 

Mantis 

MediaWiki 1.4.0 

Per la creazione di 
documentazione 

Directory /MediaWiki 

James 2.2.0 

Il server di posta di Apache 

Directory /James 

Icecast 2.2.0 

Il server di streaming 

Directory: Icecast 

SquirrelMail 

La capostipite delle 
WebMail 

Directory /SquirrelMail 

Struts 1.2.4 

Il FrameWork per costruire 
applicazioni conformi 
all'MVC 

Directory /Struts 

PircBot 1.4.4 

Un bot ire programmabile 
in Java 

Directory /PircBot 

Brupal 4.6.0 

Il principe delle piattaforme 
di Blogging 

Directory: /Drupal 

Thinlet 

Le API per creare interfacce 
usando XML 

Directory /Thinlet 

Dia 0.94 

Crea diagrammi di flusso 
con semplicità 

Directory: Dia 

Gef 

Graphical Editing 
Framework 

Directory /Gef 

Irrlicht0.9 

La nuova versione 

del motore 3D più in voga 

del momento 

Directory /irrlicht 
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MICROSOFT 

RILASCIA 

IROMPYTHOM 

Anche questa è una news 
che scotta. Che Python 
fosse un linguaggio emergente, 
non c'erano dubbi. Che fosse 
talmente emergente e talmen- 
te ben considerato che persino 
Microsoft rilasciasse un'imple- 
mentazione del linguaggio da 
far girare su piattaforma .NET 
questo era molto meno proba- 
bile, ed invece all'indirizzo 
http:llworkspa.ces. gotdotnet 
.comlironpython è possibile 
proprio scaricare una pre- 
alpha release del linguaggio da 
integrare nel .NET framework. 
Potrebbe essere una mossa 
azzeccata per portare una 
parte degli sviluppatori Open- 
Source, che sono notoriamen- 
te l'avversario più temibile di 
MS a sviluppare applicazioni 
utilizzando strumenti nativi 
per l'OS di casa Redmond. 
Come si suol dire, se non li 
puoi abbattere, fatteli amici. 



ARRIVA 
ENDIAN 
FIREWALL 

L'annuncio dell'arrivo di 
Endian Firewall ha susci- 
tato un certo scalpore nella 
comunità informatica. Il moti- 
vo principe dell'interesse 
suscitato da questo Firewall 
nasce dal fatto che è il primo 
sistema di sicurezza italiano 
opensource e con licenza GPL 
ad essere stato pensato per 
girare su sistemi Embedded. 
Endian si è concentrata nell'e- 
voluzione di IPCop, già nota 
per essere una distribuzione 
Linux OpenSource dedicata 
alla sicurezza. Le migliorie 
apportate da Endian hanno 
portato alla creazione di un 
sistema composto in 160 pac- 
chetti e concentrato in 100MB 
interamente dedicato alla 
security, ideale per girare su 
sistemi Embedded come su 
macchine ormai datate 
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RILASCIATO IL 
GCC 4.0 

Il GCC è il cuore pulsante di 
ogni progetto OpenSource 
che si rispetti. Non solo, spes- 
so e volentieri soluzioni an- 
che ideate per i sistemi Win- 
dows vengono costruite uti- 
lizzando porting del GCC. 
Fatte queste premesse si 
intuisce il clamore che il rila- 
scio di una major version su- 
scita nel mondo della pro- 
grammazione. Il CHANGE- 
LOG ovvero le note che ac- 
compagnano il rilascio e che 
descrivono i cambiamenti ri- 
spetto alla precedente ver- 
sione è di dimensioni gene- 
rose ed è reperibile all'indi- 
rizzo http://gcc.gnu.org/gcc- 
4.0/chanqes.html. Tuttavia 



fra le novità è importante 
sottolineare il supporto a 
SSA, Static Single Assign- 
ment Form. SSA è un argo- 
mento piuttosto complesso, 
riassumiamo brevemente 
che questa innovazione otti- 
mizza la generazione del co- 
dice, aumentando la velocità 
dell'applicativo. 

CENTO MILIONI 



PER SKYPE 

he il Voice Over IP fosse 
uno degli elementi chia- 
ve per il rinnovo dei servizi 
all'utenza comune era pale- 
se. In Italia diverse compa- 
gnie avevano tentato di lan- 
ciare servizi basati su VOIP, 
nessuna aveva ottenuto il 
successo che sta ottenendo 
Skype. Peccato che in Italia 
forse i tempi non siano anco- 
ra sufficientemente maturi 
per apprezzare il servizio. In 
Danimarca, Finlandia, Fran- 
cia, Hong Kong, Norvegia, 
Svezia, Regno Unito e Stati 
Uniti gli utenti possono già 
richiedere fino a tre numeri 
di telefono per essere sem- 
pre raggiungibili anche da 
utenti non appartenenti al 
circuito di skype. 



Adobe Systems Incorpora- 
ted leader nel campo della 
grafica professionale per la 
carta stampata soprattuto con 
software del tipo Adobe Pho- 
toshop, Adobe Illustrator, Ado- 
be Indesign ha annunciato di 
avere raggiunto un accordo 
definitivo per l'acquisizione di 
Macromedia, leader indiscus- 
so nel campo della grafica per 
il Web con software del calibro 
di Macromedia Flash, Macro- 
media DreamWeaver, Macro- 
media Fireworks. Il valore della 
transazione si aggira intorno ai 
3.4 miliardi di dollari. Non ci 
sarà però uno scambio fisico di 



denaro, di fatto l'intera opera- 
zione si concluderà scambian- 
do azioni. Sono previste 0,69 
azioni di Adobe per ogni azio- 
ne di Macromedia, con la valu- 
tazione di un titolo Macrome- 
dia in 41,86$. Rimane da deci- 
dere la composizione del con- 
siglio d'amministrazione, ma i 
bene informati sostengono 
che la direzione rimarrà salda- 
mente nelle mani di Adobe. 
Tuttavia i rappresentanti di 
Macromedia godranno di una 
presenza significativa. Al di la 
del valore strettamente econo- 
mico dell'operazione è impor- 
tante valutare il senso com- 




AGGIORNAMENTI PER 
WINDOWS UPDATE 



Microsoft ha appena ri- 
lasciato la prima Re- 
lease Candidate del nuovo 
Windows Server Update Ser- 
vices, nome in codice WSUS. 
Si tratta del servizio che con- 
sente agli utenti Windows di 
mantenere aggiornato il pro- 
prio computer. Come noto il 
servizio si basa su due com- 
ponenti, uno installato lato 
client e un lato web. 
Attraverso uno scambio di 
dati, il client scarica dal ser- 
ver sempre le versioni ag- 
giornate dei componenti di 
sistema, questo consente di 
tenere la propria macchina 



sempre aggiornata con le 
ultime patch di sicurezza e 
con le release più recenti dei 
prodotti. Nella nuova versio- 
ne è previsto un aumento 
della larghezza di banda e 
quindi una conseguente 
maggiore velocità nello sca- 
ricare gli aggiornamenti, un 
supporto migliorato verso il 
multilingua e un range di 
prodotti allargati. 
Chi volesse provare il nuovo 
servizio può registrarsi all'in- 
dirizzo httpjlwww.microsoft 
.com/windowsserversystem 
lupdateserviceslevaluationltr 
ialldefault. mspx. 
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merciale di questa acquisizio- 
ne. L'unione delle due compa- 
gnie configura un colosso ca- 
pace di contrastare in modo 
inequivocabile le mosse di 
chiunque altro volesse tentare 
la scalata al campo della gra- 
fica, fosse essa rivolta al Web, 
alla carta stampata o alla televi- 
sione. 

Per quello che riguarda l'uten- 
za comune, questa fusione non 
può che tracciare una linea 
verso applicazioni sempre più 
interessanti. Adobe e Macro- 
media rappresentano da sole la 
massima espressione della cre- 
atività nel campo degli stru- 
menti dedicati alla grafica, e la 
fusione di elementi così geniali 
non potrà che portare alla crea- 
zione di software sempre più 
utile e sofisticato. 
D'altro canto registriamo una 
clamorosa assenza di concor- 
renza che ci incute, come sem- 
pre in questi casi, un moderato 
timore. 



OTTAVA VERSIONE 
PER OPERA 



Nella guerra fra browser fra un Firefox 
che avanza, un Internet explorer che 
annuncia la sua versione numero 7, non 
poteva mancare il rilascio di Opera release 
numero 8. Forse un pò troppo tardi aggiun- 
giamo noi. Firefox e Internet Explorer non 
sono concorrenti a cui si possa concedere un 
minimo vantaggio. E comunque le novità di 
questa nuova versione di Opera sono rile- 
vanti. Prima di tutto si parla di una funzio- 
nalità per il resizing automatico delle 
pagine, ovvero riducendo la finestra 
del browser si avrà contestualmente un 
ridimensionamento degli oggetti che la 
compongono. Gli altri miglioramenti 
coinvolgono la sicurezza. Opera dichia- 
ra che il browser è stato progettato con 
un occhio particolare alla sicurezza 
degli utenti che lo utilizzano. Ancora in 
evidenza la possibilità di comandare il 
browser utilizzando la voce. Infine 



Opera rimane ovviamente multipiattafor- 
ma, funziona sia su Windows che su Linux 
che su Mac OS. Sicuramente si tratta di un 
browser tecnologicamente evoluto, il primo 
ad avere portato alla ribalta le tabsheet per 
la navigazione, e anche questa nuova ver- 
sione non tradisce le aspettative. Certo 
adesso riconquistare le posizioni perse a 
favore di Explorer e soprattuto di Firefox 
non sarà cosa da poco. 



OPERA 8 

SPEED, SECURITY, SIMPLICITY 

\^ Opera raceived PC Wtarftfs Beat Browser Awarol in Z«M 
$ Opera hasthabastsecuiily Ira* naconJ or any browser 




NASCE IL VISUAL BASIC 6.0 
RESOURCE CENTER 



La volontà di Microsoft di volere fa- 
vorire il passaggio degli sviluppato- 
ri Visual Basic al mondo .NE T è evi- 
dente. L'annuncio della creazione di 
questo Visual Basic Resource Center 
che fisicamente risponde all'indirizzo 
http://msdn.microsoft.com/VBRun / 
segue quello che aveva esplicitato la 



esempi di applicazioni "notevoli" scrit- 
te in VB6, dall'altro un'intera sezione è 
dedicata all'uso congiunto di tecnolo- 
gie .NET con quelle classiche. Il senso è 
evidente, mostrare agli sviluppatori 
VB6 come e quanto la nuova tecnolo- 
gia .NET possa essere utilizzata per 
migliorare il loro lavoro. L'obiettivo è 



volontà del colosso di Redmond di ces- gradualmente portare i programmatori 



r - "f- ni ro,p,r 



»Gettlng Startad &LS BS t Headlines 



sare il supporto a VB6. La creazione di 
questo polo non indica un 
cambio di rotta nelle politi- 
che di Microsoft, semmai 
mostra come la procedura 
di passaggio da VB6 alla 
piattaforma .NET stia pro- 
cedendo talmente a rilento 
da costringere la società di 
Bill Gates a creare strumen- 
ti che gradualmente metta- 
no in grado i programma- 
tori di abbracciare la nuova 
tecnologia. Se da un lato 
nel VBRun trovano posto 



a migrare a .NET in modo indolore. 
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VISUAL STUDIO 
2005 ULTIMA 
TAPPA 

Microsoft ha appena rilasciato un'al- 
tra versione preview di Visual Studio 
2005, .NET 2.0 e SQL Server 2005. 1 pro- 
grammatori attribuiscono a questi tre 
progetti un'importanza estremamente 
rilevante. A fare la parte del leone è sicura- 
mente .NET 2.0 che include novità di una 
certa importanza che rappresentano un 
notevole salto di qualità alla già rivoluzio- 
naria tecnologia .NET. Non sono da meno 
gli altri due tool che compongono il tritti- 
co: Visual Studio 2005 e SQL Server 2005. Il 
primo sarà il naturale supporto program- 
matico per .NET 2.0, secondo è il conte- 
nitore di dati per eccellenza sulla base del 
quale si fondano moltissime applicazioni 
soprattutto professionali in ambito 
Windows. Al di la delle note tecniche che 
riempiono di contenuto le nuove versioni, 
è importante notare che queste preview 
per la prima volta utilizzano la licenza 
GoLive che consente agli sviluppatori di 
utilizzare questi software per la produzio- 
ne di applicazioni destinate alla distribu- 
zione eccetto che per il framework 2.0. 
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L'esperto risponde... 



Testare il DNS 



Buongiorno cari 
ioProgrammatori. Da qual- 
che tempo sto cercando di con- 
figurare il BIND per una serie 
di domini che mantengo in 
multihoming sul mio indirizzo 
IP fisso di casa. Non riesco 
ancora a capire se ho configu- 
rato bene il DNS, perché in 
alcuni casi mi accorgo che 
viene risolto correttamente, in 
altri no. C'è un modo per capi- 
re se si tratta di un problema 
di rete o di diffusione del dns 
o un problema di configurazio- 
ne? 

Antonio 

Antonio, un buon modo per chia- 
rirsi ogni dubbio è consultare i 
siti http://www.dnsstujf.com e httpllwww 
.dnsreport.com che mettono a disposi- 
zione dei test standard e provati per 
la verifica della corretta configura- 
zione del dns. 

Non riesco a installare 
l'estensione PDF per PHP 

Da più di un anno compro la 
vostra rivista ed è vera- 
mente speciale. Grazie ai vostri 
ed ho installato Apache, php5 
e Mysql. Grazie ad un vostro 
articolo sul numero 84 ho con- 
figurato Apache Mysql e Php5 
e tutto è andato bene. 
Purtroppo quando cerco di 
decommentare la linea di codi- 
ce nel file php.ini corrispon- 
dente alla libreria php_pdf.dll 
per creare un documento pdf, 
viene fuori una finestra che mi 
dice di non riuscire a trovare il 
modulo php_pdf.dll. Mi potre- 
ste aiutare a risolvere questo 
problema? 

Aurelio 



Gentile Aurelio, tutte le estensioni 
di PHP si trovano nella directory 
ext situata sotto la radice di PHP. Per 
prima cosa controlli che la dll in que- 
stione sia presente in quella direc- 
tory. Apra poi il file php.ini e control- 
li la seguente riga: 



extension_dir 



./ext" 



Questa istruzione avverte PHP di 
cercare le estensioni nella directory 
ext immediatamente sotto il percor- 
so di installazione di PHP. Infine de- 
commenti la linea 

;extension= php_pdf.dll 

Riawii Apache. Se tutto andrà a 
buon fine, non riceverà errori. Può 
effettuare un successivo controllo 
creando un file info.php contenente 
le seguenti istruzioni: 



<? 



phpinfo(); 



?> 



Puntando il browser all'indirizzo 
http:lllocalhostlinfo.php otterrà una pa- 
gina contenente tutte le caratteristi- 
che di installazione del PHP. Nella se- 
zione delle estensioni comparirà an- 
che quella relativa ai PDF. 
Se così non fosse, qualcosa è andato 
storto. Dovrà adattare la linea exten- 
sion_dir al path della sua installazio- 
ne di PHP. 

Quando e perché installare 
un firewall? 

Gentile redazione. Ho visto 
che con il SP2 di Windows 
viene installato di default un 
firewall. Se, per caso, lo disabi- 
lito, il sistema mi avverte che 
sono esposto a rischi. Ma a 
quali rischi sono esposto? Da 
cosa mi protegge il firewall? 



Ho letto il vostro articolo sugli 
attacchi Ddos e, dato che spes- 
so mi capita che il computer 
rallenti quando sono connesso 
a Internet, vorrei capire se 
secondo voi può dipendere da 
un attacco Ddos. Con il 
Firewall aperto non dovrei 
essere protetto? 

Gianluca 

Un firewall è un software che fil- 
tra i pacchetti quando arrivano 
alla macchina su cui è installato. 
Filtrare i pacchetti significa che la 
scheda li riceve, ma non lascia che 
vengano elaborati dal software a cui 
sono destinati. Ad esempio: un pac- 
chetto destinato alla porta 80 potreb- 
be essere bloccato all'ingresso dal fi- 
rewall, questo significa che il vostro 
Web Server, ovvero il servizio che gi- 
ra sulla porta 80 non riceverà mai 
quel pacchetto e non elaborerà mai i 
comandi che conteneva. 
Va da sé dunque, che un Firewall è 
utile per far sì che pacchetti con 
istruzioni pericolose non arrivino a 
determinati servizi. Se per esempio 
state chattando, sulla vostra macchi- 
na si apriranno delle porte. Un ma- 
lintenzionato potrebbe mandare dei 
pacchetti su queste porte tentando 
di sfruttarle per eseguire istruzioni 
pericolose o non consentite. Per cui 
un firewall è utile per far sì che i pac- 
chetti non giungano a destinazione. 
È meno utile in caso di attacchi 
Ddos. Di fatto un attacco Ddos è 
composto in modo che l'attaccante o 
gli attaccanti tentino di saturare le 
risorse della vostra macchina. Ad 
esempio: se la vostra macchina rice- 
vesse 1.000.000 di ping in brevissimo 
tempo, dovrebbe elaborare 1.000.000 
di pacchetti, con un conseguente ral- 
lentamento. Se ci fosse un firewall 
installato, sarebbe il firewall a dover 
gestire i pacchetti in arrivo. 
Chiaramente questa attività rallente- 
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rebbe il Sistema Operativo. In con- 
clusione: installare un firewall sulla 
propria macchina è importante per 
non lasciare passare pacchetti poten- 
zialmente pericolosi, abbastanza 
inutile invece nel caso di attacchi 
DDos. Se si temono questo genere 
d'attacchi è utile nascondersi dietro 
un router; in tal caso la vostra naviga- 
zione su Internet sarà lenta o inattua- 
bile, ma localmente il vostro sistema 
non subirà eccessivi rallentamenti. 

Programmazione di IRC 

Cari amici di ioProgrammo, 
sono uno studente di inge- 
gneria informatica al primo 
anno. Passo molto tempo in 
IRC e mi piacerebbe avere un 
canale tutto mio. Ho visto che i 
canali sono spesso mantenuti 
da bot. Vorrei capire come sono 
fatti questi bot e come funzio- 
nano. Mi spiegate qualcosa in 
più? 

Michele 



Caro Michele, i bot ire sono ovvia- 
mente tenuti in piedi da un soft- 
ware che emula una persona umana, 
sfrutta i tradizionali protocolli ed oc- 
cupa un canale ire. La differenza so- 
stanziale con le persone umane è che 
sono programmabili. Dove per pro- 
grammabili si intende che possono 
compiere azioni specifiche in reazio- 
ne ad eventi specifici. Se per esempio 
un utente non gradito entra in un ca- 
nale, sono in grado di riconoscerlo 
attraverso la sua mask ed espellerlo. 
Possono mantenere una lista degli 
utenti non graditi, oppure una lista di 
utenti a cui passare Top quando en- 
trano in un canale. Chiaramente, 
qualunque software conforme agli 
standard Ire, potrebbe essere pro- 
grammato per assolvere alle funzioni 
che abbiamo appena esposto, tutta- 
via c'è uno standard che si è afferna- 
to nel tempo ed è l'Eggdrop - 
http://www.geteggdrop.com - Si tratta di 
un software scritto in C++, Open- 
Source e liberamente disponibile, per 
cui studiabile anche per comprende- 



A chi spedire la posta? 

Problemi sugli allegati 



Alla nostra redazione arriva spes- 
so un considerevole numero di 
email riguardante temi specifici. 
Per consentirci di rispondere 
velocemente e in modo adeguato 
alle vostre domande abbiamo ela- 
borato una FAQ - Frequently Ask 
Question - o risposte alle doman- 
de frequenti in italiano, di modo 
che possiate indirizzare le vostre 
richieste in modo mirato. 

Problemi sugli 
abbonamenti 

Se la tua domanda ha a che fare 
con una delle seguenti: 

• Vorrei abbonarmi alla rivista, 
che devo fare? 

• Sono un abbonato e non ho 
ricevuto la rivista, a chi devo 
rivolgermi? 

• Sono abbonato ma la posta 
non mi consegna regolar- 
mente la rivista, a chi devo 
rivolgermi? 

Contatta abbonamenti@edma- 
ster.it specificando che sei inte- 
ressato a ioProgrammo. Lascia il 
tuo indirizzo email e indica il 
numero dal quale vorresti far par- 
tire l'abbonamento. Verrai contat- 
tato al più presto. Oppure puoi 
chiamare lo 02 831212 



Se riscontri un problema del tipo: 

• Ho acquistato ioProgrammo 
ed il Cdrom al suo interno 
non funziona. Chi me lo 
sostituisce? 

• Ho acquistato ioProgrammo 
ma non ho trovato il cd/dvd 
all'interno, come posso otte- 
nerlo? 

• Vorrei avere alcuni arretrati 
di ioProgrammo come fac- 
cio? 

Contatta servizioclienti@edma- 
ster.it 

Non dimenticare di specificare il 
numero di copertina di 
ioProgrammo e la versione: con 
libro o senza libro. Oppure telefo- 
na allo 02 831212 

Assistenza tecnica 

Se il tuo problema è un problema 
di programmazione del tipo: 

• Come faccio a mandare una 
mail da PHP? 

• Come si instanzia una varia- 
bile in c++? 

• Come faccio a creare una 
pagina ASRNET 

o un qualunque altro tipo di pro- 



blema relativo a tecniche di pro- 
grammazione, esplicita la tua 
domanda sul nostro forum: 
http://forum.ioprogrammo.it, 
uno dei nostri esperti ti rispon- 
derà. Le domande più interessan- 
ti saranno anche pubblicate in 
questa rubrica. 

Problemi sul codice 
all'interno del CD 

Se la tua domanda è la seguente 

• Non ho trovato il codice rela- 
tivo all'articolo all'interno 
del ed 

Consulta la nostra sezione down- 
load all'indirizzo 
http://cdrom.ioprogrammo.it, 

nei rari casi in cui il codice colle- 
gato ad un articolo non sia pre- 
sente nel cdrom, senza dubbio 
verrà reso disponibile sul nostro 
sito. 

Idee e suggerimenti 

Se sei un programmatore esperto 
e vuoi proporti come articolista 
per ioProgrammo, oppure se hai 
suggerimenti su come migliorare 
la rivista, se vuoi inviarci un truc- 
co suggerendolo per la rubrica 
tips & tricks invia una email a 
ioprogrammo@edmaster.it 



re come questi meccanismi vengono 
gestiti. Altra importante funzionalità 
di un eggdrop è che può essere este- 
so tramite script realizzabili in TCL. 
Per cui ad esempio puoi installare il 
tuo Eggdrop che si connette automa- 
ticamente a Ire e compie le azioni di 
base, per poi estenderlo usando tei 
per compiere azioni specifiche. Si 
stanno molto diffondendo negli ulti- 
mi tempi, script che realizzano quiz 
su canali ire. 

IIS6 e Apache non 
funzionano insieme sulla 
stessa porta 

Ho appena comperato una 
macchina per fare hosting. 
Dato che la maggior parte dei 
software: PHP, MySQL girano 
anche in ambiente Windows 
mentre il contrario, cioè ASP e 
ASP.NET su ambiente Linux è un 
po' più complesso, ho deciso di 
acquistare una macchina 
Windows 2003 con IIS6 
installato sopra. Nonostante 
questo vorrei tenere attivo 
anche Apache. Ho provato in 
tutti i modi ma non c'è verso di 
fare girare MS e Apache sulla 
stessa porta. Conoscete 
qualche trucco per farlo? 

Fernando 

E impossibile fare girare due servi- 
zi sulla stessa porta e sullo stesso 
IP. È invece possibile fare girare due 
servizi che offrono identici servizi su 
porte differenti ad esempio la 80 per 
US e la 8080 per Apache. Tuttavia 
questo non sembra essere il tuo 
obiettivo. È anche possibile fare gira- 
re due servizi identici sulla stessa 
porta ma su indirizzi IP differenti. 
Questa operazione presenta qualche 
problema. Nel caso di IIS6 poi è asso- 
lutamente incompatibile. IIS6 usa 
infatti un meccanismo chiamato 
SocketPooling che tralasciando i det- 
tagli più tecnici, impedisce di fatto di 
fare girare Apache e IIS6 sulla stessa 
porta anche se su IP differenti. 
Sarebbe necessario disabilitare il 
SocketPooling su IIS6 ma questa ope- 
razione sconsigliata rallenterebbe di 
molto il server. 
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Direttamente dal forum di ioProgrammo le discussioni più "Hot" del momento 
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ADO.NET 



iifTEffi» 



Come mettere una 
intestazione di colonna 
in ADO.NET 

Volevo sapere se esiste una 
proprietà per dare il nome 
anche alle righe come alle 
colonne. Ad esempio: 

I Titolo I Titolo 
I Colonnal I Colonna2 



-I- 



■I- 



TitoloRiga I Valore I Valore 
1 1 

Rappresentazione Standard: 
I Prodotto I Descr. 



-I- 



■I- 



I 1 



PC 



http://forum.ioprogramrno.net/thread.php7threa 
did=5463&boardid=27 

sklero 

Risponde Francesco Smelzo 

Per fare bene dovresti: 

• alterare la fonte dei dati in modo 
che la prima colonna del Da- 
taTable contenga il nome di riga. 

• Create una estensione della classe 
DataGridColumnStyle da applicare 
alla prima colonna in modo che il 
nome di riga non venga in una 
textbox, non sia editabile e maga- 
ri venga disegnato con uno sfon- 
do tipo bottone. 

• Prima dell'associazione dbGridlda- 
tasource devi creare un nuovo Da- 
taGrìdTableStyle nella collection Ta- 
bleStyles della dataGrid rimappan- 
do i campi del DataTable e asso- 
ciando quello della prima riga alla 
classe di estensione di sui sopra. 



In realtà, questo sarebbe il metodo 
migliore, ma se i tempi sono stretti 
puoi anche, visti i tempi che hai, uti- 
lizzare il controllo FlexGrid di vb6 
direttamente da VB.NET. 
Un modo per farlo è il seguente: 

In Visual Studio: 

1. Clicchi con il tasto destro sul pan- 
nello strumenti 

2. Aggiungi/rimuovi elementi 

3. Nella finestra scegli "Componenti 
Com" e quindi selezioni "Microsoft 
Flex Grid" 

Ti dovrebbe quindi apparire il con- 
trollo sul pannello strumenti. 
Lo usi come in vb6, ricordati però che 
i dati non gli devono arrivare diretta- 
mente daADO.NET ma dal "vecchio" 
ADODB che puoi ancora invocare da 
VB.NET anche con il classico: 

dim conn as object=CreateObject( 

"ADODB.CONNECTION") ecc.. 



Visual Basic 



liTTtffiU 



Chiudere 

un processo in VB6 

Ciao a tutti, vorrei da un pro- 
gramma scritto in vb6 chiu- 
dere un altro programma sem- 
pre scritto in vb6. Ho utilizzato 
alcune api, trovate in internet, 
ma... non funzionano non mi 
chiude il processo. 
Come posso fare? 
http://forum.ioprogrammo.net/thread.php7threa 
did=5446&boardid=13 

Toyota 
Risponde SimoneVB 

Ci sono diverse soluzioni possibili. 
Quella che ti consiglio fa uso delle 



classi di WMI (argomento trattato 
recentemente da ioProgrammo). 
Da VB puoi utilizzare Windows Ma- 
nagement Instrumentation riferen- 
doti alla libreria "Microsoft WMI 
Scripting vl.l Library" oppure in 
late-binding come nell'esempio che 
segue: 

Sub TerminateProcess(ByVal ProcessName 
As String) 

' Termina un processo 

Dim oLoc 



Dim oServ 



Dim oObjectSet 



Dim oProc 



Dim sMsg As String 



query WQL 



Const sWQL As String = "SELECT * FROM 

Win32_Process WHERE Name = 
'notepad.exe'" 



oggetto locator 



Set oLoc = CreateObject( 

"WbemScripting.sWbem Locator") 

Set oServ = oLoc.ConnectServer(".", 

"root\cimv2") 

Set oObjectSet = oServ.ExecQuery(sWQL) 
For Each oProc In oObjectSet 



If MsgBox("Terminare " & oProc.Caption _ 
& " ?", vbExclamation + vbYesNo, 
"Termina processo") = vbYes Then 
oProc. Terminate 



Next 


Set oProc 


= Nothing 


Set oObjectSet = Nothing 


Set oServ 


= Nothing 


Set oLoc = 


Nothing 



End Sub 

Chiaramente, devi controllare che 
WMI sia installato e che il notepad 
sia in esecuzione. In realtà potresti 
anche parametrizzare la query per 
rendere tutto più portabile. 
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Nominare sequenzialmente 
i file in VB 

Ho realizzato un erigine per 
scacchi. Il programma è in 
test, per cui creo un file 
testuale di debug. Il banale 
problema che ho è che vorrei 
dare al file il nome del giocato- 
re contro cui gioca, ma con un 
numero sequenziale creato dal 
programma: cioè se esiste 
pippo03 vorrei nominare il file 
pippo04. Al momento, l'unico 
modo che conosco per sapere 
se un file esiste, è eseguire la 
open: 

1)con "on error" il file non c'è e 
quindi apro il file col nome 
dell'avversario 

2)il file c'è, quindi devo dare 
un altro nome, incrementan- 
do 03, 04, 05.. 

È laborioso anche perché non 
so quanti ce ne possano essere 
di file. .di pippo.. Chi mi sugge- 
risce un metodo diverso? 

http://forum.loprograinino.net/thread.php7threa 

did=5426&boardid=13 

Dario 70 

Risponde Hyde 

Se non vuoi scomodare il FileSystem 
per non provocare un overhead del 
sistema e comunque per utilizzare 
una sintassi più semplice ed imme- 
diata, puoi utilizzare qualcosa di 
questo genere, che ti semplifica di 
molto la vita. 

Private Function FileExist(ByVal nfile As 

String) As Boolean 

On Error Resumé Next 

FileExist = (GetAttr(nfile) 

And vbDirectory) = 
End Function 




Chiamare un WebService 
da JSP 

Salve a tutti, sto tentando di 
richiamare da una pagina 
jsp di un sito sotto tomcat, un 
web service da me sviluppato, 
funzionante e pubblicato fra 
l'altro sulla stessa macchina, 
sotto tomcat/axis. 
Attualmente dalla pagina jsp 
chiamo una classe bean che ha 
un metodo al cui interno ho 
messo il codice che chiama il 
web service (Cali cali = new cali 
etc...): non vuole funzionare mi 
dà errore Jasper e Servlet. 
Il bean con metodi banali fun- 
ziona. 

http://forum.ioprogrammo.net/thread.php7threa 

did=5363&boardid=18 

webmasterit77 

Risponde doc 

Io di solito creo lo stub dal WSDL e 
poi da una pagina jsp lo richiamo in 
questo modo 

<% 

try 

{ 

StubServizio stub = new StubServizio(); 
result = stub.sayHello("Ciao"); 



catch (Exception e) 

{ 

result = "Problemi!!!" 



%> 

Per creare lo stub puoi usare wsdl2- 
java che crea automaticamente tutto. 



che l'applicazione di riconosci- 
mento vocale possa funzionare. 

Il mio problema sarà sem- 
plicissimo per i più: come si 
passa tale valore alla JVM? 
http://forum.ioprogrammo.net/thread.php7threa 
did=5379&boardid=18 

Sonique 
Risponde Doc 

Semplicemente devi passare quel 
valore quando lanci l'applicazione 
che usa Sphinx4, in questo modo 

java -mx312m MioProgCheUsaSphinx4 



^ 



C++ 



Come gestire una Sequenza 
di Label in C# 

Salve a tutti. Ho tante label 
etichettate con il nome: 

/o/Ab 7 



lblAb30 

Se volessi ricorrere ad un ciclo 
for per impostare un parame- 
tro come posso fare? 

http://forum.ioprogrammo.net/thread.php7threa 

did=5388&boardid=29 

Merlino666 

Risponde Antonio Pelleriti 

Puoi usare un foreach per effettuare 
un ciclo su tutti i controlli e verificare 
quali di essi sono di classe Label. 
Se il controllo corrisponde alla classe 
desiderata puoi settarne le proprietà 
secondo le tue esigenze. 
Ad esempio, così si imposta a rosso il 
BackColor di tutte le Label: 



Chiaramente la funzione restituisce 
un booleano a seconda che il file esi- 
sta oppure meno. Il resto è abbastan- 
za semplice. In questo modo non 
devi aprire e chiudere un file tutte le 
volte che vuoi controllarne l'esisten- 
za. La conseguenza immediata è un 
minore rallentamento dell'applica- 
zione. 



Chiarimenti su 
"a parola di java' 



Ciao a tutti, trovo molto 
interessante l'articolo pro- 
posto da numero di Aprile di lo 
Programmo. Ad un certo punto 
però si consiglia di passare il 
valore -mx312m alla JVM affin- 



Label lab; 






fo 


-each(Control e in thìs. Controls) 


{ 




if(c 


is Label) 




{ 


lab=(Label)c; 






lab.BackColor= 


=Color.Red; 


} 
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Gestire la Cam 
del Cellulare 

La teoria e la tecnica per creare una completa applicazione per 
catturare immagini e video dal telefonino e inviarle a un server su 
Internet. Un ottimo punto di partenza per creare un blog fotografico 




□ 



CD Q WEB 



"^ 



■■*"*■■ ■■■""-■ 



J 



Ly idea di questo articolo è molto semplice. 
Possedete un cellulare di ultima generazione 
A in grado di realizzare e salvare filmati? Molto 
semplicemente costruiremo un'applicazione perso- 
nalizzata che vi consentirà di girare una scena con il 
cellulare e salvarla direttamente su un server in 
internet. Non ci crederete, ma questo tipo di mec- 
canismo si sta diffondendo con il nome di MoBLOG, 
si tratta di blog dove invece di postare testi si invia- 
no foto e filmati, appunti di vita quotidiana. 



COME FUNZIONERÀ 
L'APPLICAZIONE 

Possiamo pensare che, una volta avviata l'applica- 
zione, essa ci mostri ciò che la telecamera riprende. 
Una serie di comandi ci aiuteranno ad individuare le 
azioni da intraprendere. Alla voce "Opzioni", sulla 
barra dei comandi del telefono, corrisponderà un 
menu a tendina, in cui vengono visualizzate le voci 
"Cattura foto", "Registra video". Quando si preme il 




tasto "fire" relativo alla voce "Cattura foto" il display 
cattura un'immagine e la visualizza. A questo punto 
avremo due opzioni: "Invia al repository" o "Indie- 
tro". Nel primo caso potremo inserire in un TextField 
il nome del file in cui salveremo i dati sul server e 
premendo "Invia" una pop-up ci avvertirà che il tra- 
sferimento è in corso o in caso di problemi di rete ci 
inviterà a riprovare più tardi. Comunque si tornerà 
alla vista sulla camera attiva. Se desideriamo regi- 
strare un video, continueremo a mantenere la vista 
sulla camera attiva e l'unica azione che potremo ef- 
fettuare sarà lo "Stop registrazione". Una volta fer- 
mata la registrazione viene visualizzato l'ultimo fra- 
ine del video e il comportamento è uguale al caso 
precedente, con le due opzioni "Invia al repository" 
o "Indietro". 




Il primo passo per svi- 
luppare un'applicazio- 
ne MMAPI è indivi- 
duare i tools appro- 
priati. Il Sun J2ME 
Wireless Toolkit inclu- 
de il supporto per 
MIDP 2.0 e MMAPI 1.1 
e fornisce alcuni emu- 
latori standard, è ne- 
cessario scaricarlo 
all'indirizzo: 
http://java.sun.com 



Tempo di realizzazione 



Fig. 1: Cliccando su options apparirà il menu per 
inviare la foto 



/products/j2mewtoolkit/ 
In alternativa si può 
utilizzare il Nokia De- 
veloper's Suite for 
J2ME disponibile sul 
Forum Nokia 
www.forum.nokia.com. 
il sito di Nokia per gli 
sviluppatori. Questa 
suite contiene gli 
emulatori per molti 



modelli di cellulari 
Nokia e le SDK per po- 
ter sviluppare applica- 
zioni utilizzando API 
proprietarie di Nokia. 
Gli emulatori possono 
essere inclusi anche 
nel Wireless Toolkit. 
Emulatori per cellulari 
di altre marche (ad 
esempio Sony Erics- 
son) si possono scari- 
care solitamente dai 
siti della casa produt- 
trice e poi si possono 
includere facilmente 
nel Wireless Toolkit: 
basta copiare la direc- 
tory relativa all'emu- 
latore in C:\WTK22 
\wtklih\devices se 
C:\WTK22 è la root 
dove è installato il 
Wireless Toolkit. 
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FACCIAMOLO IIU JAVA 

Le applicazioni Java che girano su dispositivi MIDP 
sono chiamate MIDlet. Una MIDlet è costituita da 
almeno una classe derivata dalla classe astratta 
javax.microedition.midlet.MIDlet. La struttura di 
una MIDlet è la seguente: 

public class MyMIDIet extends MIDlet { 

CameraMIDIet( ) {} 

protected void startApp( ) throws 

MIDIetStateChangedException {} 
protected void pauseApp( ) {} 
protected void destroyApp(boolean unconditional) 

throws MIDIetStateChangedException {} 
} 

Nel metodo startAppO deve essere implementata la 
logica di esecuzione della MIDlet. Tale metodo viene 
richiamato subito dopo che è stato invocato il co- 
struttore ed è stata inizializzata la MIDlet. La piatta- 
forma MIDP può mettere la MIDlet in uno stato di 
pausa, se, ad esempio, durante la sua esecuzione ar- 
riva una telefonata. In questo caso viene chiamato il 
metodo pauseAppO, che va quindi implementato in 
modo da sospendere l'esecuzione. Analogamente 
deve essere implementato metodo destroyApp () 
che deve rilasciare tutte le risorse allocate, stoppare 
i thread in backgroud e chiudere l'applicazione. 



MOBILECAMERA MIDLET 

Per quello che ci riguarda la nostra Midlet si chia- 
merà MobileCameraMIDlet e come già detto esten- 
derà la classe astratta MIDlet. Nel suo metodo start - 
App ( ) vengono create le instanze dei due oggetti 
CameraCanvas e SendCanvas e viene chiamato il 
metodo start ( ) di CameraCanvas che awierà il con- 
trollo sulla camera. MobileCameraMIDlet, in quan- 
to oggetto principale dell'applicazione, in qualche 
modo viene utilizzato anche per coordinare le rela- 
zioni tra gli altri due oggetti. In particolare, volendo, 
che una volta catturata una foto, essa sia visualizza- 
ta sul display fino a quando non si intraprende una 
nuova azione (invio della foto al server o ritorno alla 
camera attiva), MobileCameraMIDlet riceve la foto 
catturata da CameraCanvas e la passa a SendCanvas 
che la visualizza sul display ed eventualmente la 
invierà al server di repository: 

public void cameraCanvasImageCaptured( 

byte[]imageData) { 
CameraCanvas. stop(); 
SendCanvas. setlmage(imageData); 
Display.getDisplay(this).setCurrent(displayCanvas); 



video, il display visualizzerà l'ultimo fraine del video 
ripreso, perciò SendCanvas passa a MobileCamera- 
MIDlet l'ultimo frame e l'intero video. SendCanvas 
visualizzerà sul display l'ultimo frame ed eventual- 
mente invierà il video al server di repository: 

public void cameraCanvasVideoCaptured( 

byte[]imageData, byte[]videoData) { 

CameraCanvas. stop() 

SendCanvas. setVideo(imageData,videoData); 

Display.getDisplay(this).setCurrent(sendCanvas); 
} 

In ultimo MobileCameraMIDlet si occupa di gestire 
la visualizzazione di messaggi di tipo pop-up che 
compaiono sul telefono per avvertire l'utente di una 
particolare situazione, che può essere una semplice 
informazione, un warning o un errore. L'oggetto che 
vuole utilizzare questo metodo deve passargli sola- 
mente il testo del messaggio da stampare a video: 

public void displayAlert(String body) { 

Alert alert = new Alert("", body, nuli, AlertType.INFO); 

alert.setTimeout(3000); 

Display.getDisplay(this).setCurrent(alert); 
} 



GESTIONE DELLA CAMERA 

Tutto è affidato a CameraCanvas che estende l'og- 
getto Canvas. La classe Canvas è la classe base per 
scrivere applicazioni in cui bisogna disegnare sul 
display o comunque averne un controllo a livello 
grafico. Il metodo paint ( ) è dichiarato astratto e 
deve essere implementato dallo sviluppatore. Nella 
nostra realizzazione, nel caso in cui il telefono non 
supporti la cattura video nel metodo paint ( ) andre- 
mo a colorare il display di nero, mostrando dei mes- 
saggi d'errore, altrimenti coloreremo lo sfondo di 
giallo. La classe CameraCanvas viene utilizzata per 
collegare le azioni della camera del telefono al suo 
display. All'interno di questa classe sarà quindi im- 
plementato anche ciò che riguarda le funzionalità 
specifiche richieste dalla nostra applicazione: cattu- 
ra di una foto e registrazione di un video. Vediamo 
quali sono le operazioni che vengono effettuate nel 
costruttore di CameraCanvas. Il primo passo è quel- 
lo di definire dei comandi (Command) che corri- 
spondono alle azioni "Cattura foto", "Registra video", 
"Stop registrazione", "Esci". Ciò significa che Came- 
raCanvas implementa l'interfaccia CommandListe- 
ner e definisce il metodo commandAction(Com- 
mand e, Displayable d). 

captureCommand = new Command) 

"Cattura foto",Command.SCREEN,l); 




Analogamente quando termina la registrazione del recordCommand = new Command( 
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"Registra video", Comma nd.SCREEN,!) 



stopRecordCommand = new Commandf 

"Stop registazione",Command.SCREEN,l) 



exitCommand = new Commandf 

" Esci", Command. EXIT, 1) 



addCommand(captureCommand); 



addCommand(recordCommand); 



addCommand(exitCommand); 



setCommandListener(this); 

Il comando "Stop registrazione" verrà aggiunto sol- 
tanto successivamente, perché desideriamo che 
esso compaia soltanto durante la registrazione del 
video. Il secondo passo eseguito nel costruttore con- 
siste nel connettere l'applicazione al dispositivo 
camera del telefono. L'oggetto di cui abbiamo biso- 
gno ce lo forniscono le MMAPI ed è il Player. Esso 
viene ottenuto tramite un Manager. Uno speciale 
locator, "capture:/ /video" indica che l'immagine 
sarà catturata utilizzando un formato di default.: 

player = Manager.createPlayer("capture://video"); 
Se il dispositivo non supporta la cattura video con le 



caratteristiche richieste, viene lanciata una Media- 
Exception. Occorre poi che il Player sia nello stato 
realized per ottenere le risorse di cui ha bisogno per 
catturare immagini: 

player.realize ( ); 

Per visualizzare sul display del telefono ciò che la ca- 
mera riprende, utilizziamo un oggetto derivato dal- 
l'interfaccia Control, il VideoControl. Per ottenere 
un VideoControl basta chiederlo al Player: 

VideoControl = (VideoControl)(player.getControl( 

"VideoControl")); 

A questo punto inizializziamo il VideoControl se- 
condo la modalità con cui vogliamo che il flusso ri- 
preso venga visualizzato: 

VideoControl. initDisplayMode( 

VideoControl. USE_DIRECT_VIDEO,this); 

Nel costruttore abbiamo quindi definito e preparato 



LA NOSTRA APPLICAZIONE VISTA IHI DIRETTA 
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D Avviata l'applicazione, la camera 
viene attivata e viene visualizzato 
ciò che essa riprende. Useremo i menu 
per scegliere le operazioni da compiere 

CATTURA FOTO 



n 



Premendo il tasto relativo allo voce 
"Opzioni" compare un menu a ten- 
dina: dobbiamo fare la nostra scelta: 
"Cattura foto" o "Registra video". 



SALVA CON NOME... 




^V Dopo aver scelto "Cattura foto" 
mM l'immagine viene visualizzata. 
Quando viene stoppata la registrazione 
viene visualizzato l'ultimo frame. 



Se decidiamo di inviare l'immagine 
U o il video al server prima dobbiamo 
fornire il nome con il quale essa sarà 
salvata nel repository. 



n 



Dopo aver scelto "Registra video" 
la camera resta attiva, l'applicazio- 
ne registra il video, in attesa dello "Stop 
registrazione". 



INVIO AL REPOSITORY 



R 




A questo punto inviamo l'immagine 
e attendiamo che essa venga 
trasferita. Intanto l'applicazione torna 
allo stato iniziale: vista dalla camera. 



► 16 /Giugno 2005 



http://www.ioprogrammo.it 



J2ME Multimediale ■ T COVER STORY 



all'uso tutte le risorse di cui abbiamo bisogno. Nel 
metodo start () non faremo altro che avviare il Player 
e rendere visibile sul display flusso ripreso dalla ca- 
mera: 

player.start(); 
videoControl.setVisible(true); 

Al contrario nel metodo stop ( ) stoppiamo il Player 
e rendiamo invisibile quanto ripreso dalla camera: 

videoControl.setVisible(false); 
player.stop(); 

Ora siamo in grado di vedere sul telefono ciò che la 
camera riprende. Il successivo step è intraprendere 
un'azione. Abbiamo detto che l'azione è legata ad un 
comando. Ad esempio, premendo il tasto relativo 
alla voce "Cattura foto" viene catturata una foto. Co- 
dificando quanto appena detto all'interno del com- 
mandAction(Command e, Displayable d), abbiamo: 

public void commandAction (Command e, 

Displayable d) { 
if(c == captureCommand) { 
captureFoto(); } 



Il metodo captureFoto ( ) è quello che in effetti cat- 
tura la foto, la memorizza in un array di byte e la pas- 
sa alla midlet (che a sua volta la passa a SendCanvas 
in modo che sia impostata come sfondo): 

public void captureFoto() { 
if(player != nuli) { 

try { 

imageData = videoControl.getSnapshot( 

"encoding =jpeg&width = 640&height=480"); 
midlet. cameraCanvasCaptured(imageData); 
} catch(MediaException me) { 
messagel = "MediaException:"; 
message2 = me.getMessage();} } 
} 



La cattura vera e propria viene effettuata dal metodo 
getSnapshot(String imageType). Le caratteristiche e il 
formato delle immagini sono specificate nella strin- 
ga imageType. I formati supportati possono essere 
richiesti con la chiamata System.getProperty ("video 
.snapshot.encodings"). Nel nostro caso abbiamo ri- 
chiesto delle foto in formato jpeg, 640x480. Come 
già detto, una volta catturata l'immagine essa viene 
consegnata, passando per la classe MobileCamera- 
MIDlet, a SendCanvas che la setta come sfondo e dà 
la possibilità di inviarla. Vediamo ora ciò che succe- 
de quando si preme il tasto relativo alla voce "Regi- 
stra video". Nel metodo CommandAction questa 
volta avremo: 



if (e == recordCommand) {recordVideo();} 

Il metodo recordVideo () innanzitutto rimuove i co- 
mandi "Cattura foto" e "Registrazione video" ed ag- 
giunge "Stop registrazione". Successivamente chiede 
al Player il Control di tipo RecordControl ed inizia la 
memorizzazione dei dati su un ByteArrayOutput- 
Stream: 

public void recordVideo() { 

removeCommand(captureCommand); 

removeCommand( recordCommand); 

addCommand(stopRecordCommand); 

re = (RecordControl)player.getControl( 

"RecordControl"); 

output = new ByteArrayOutputStream(); 

rc.setRecordStream(output); 

rc.startRecordO; 
} 



L'unica azione che possiamo ora intraprendere è 
"Stop registrazione": 

if (e == stopRecordCommand) {stopRecordingQ;} 




Il metodo stopRecording ( 
) interrompe la registra- 
zione, cattura l'ultimo 
frame del video, trasferi- 
sce i dati da un ByteAr- 
rayOutputStream ad un 
ByteArray e consegna ul- 
timo frame e video, pas- 
sando per la classe Mobi- 
leCameraMIDlet, a Send- 
Canvas che setterà l'ulti- 
mo frame come sfondo e 
darà la possibilità di in- 
viare il video. 




Il formato del video 
catturato sarà proprio 
quello specificato nel 
locator. 

Perciò se non fornia- 
mo altri dettagli il vi- 
deo catturato avrà di- 
mensione pari a quel- 
Ile del display e codifi- 
ca uguale a quella 
normalmente utilizza- 
ta dal dispositivo (ad 
es. mpeg). Quindi, se, 
ad esempio, il nostro 



telefono è di tipo QCIF 
(display 176x144 
pixel), ma vogliamo 
un video i cui frame 
siano ad esempio 640 
x 480, il locator sarà: 

player = Manager 
.createPlayer("capture: 
//video?widht= 
640&height=480"); 

con la stessa sintassi 
utilizzata per le uri. 



INVIARE I DATI 

SendCanvas è la classe utilizzata per l'invio dei dati 
al repository server. Essa estende la classe Canvas 
perché viene utilizzata anche per mostrare come 
sfondo sul display una data immagine. Nel costrut- 
tore di SendCanvas creiamo i comandi che ci per- 
metteranno di passare alla schermata di inserimen- 
to del nome del file (per poi inviare i dati) o tornare 
alla camera attiva: "Invia al repository" e "Indietro": 

backCommand = new Command) 

"Indietro", Command. BACK,1); 
sendCommand = new Command( 

"Invia al repository", Command. SCREEN,1); 
sendDataCommand = new Command( 

"Invia", Command.SCREEN,!); 
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addCommand(backCommand); 



addCommand(sendCommand); 



setCommandListener(this); 

Abbiamo poi i due metodi che vengono chiamati da 
MobileCameraMIDlet quando da CameraCanvas è 
stata catturata una foto o registrato un video: set- 
Image (byte[] imageData) e setVideo(byte[] image- 
Data, byte[] videoData). Il primo crea un'immagine 
dai dati ricevuti e setta il content type dei dati a "im- 
magine". Il secondo crea un'immagine da image- 
Data, memorizza il video contenuto in videoData e 
setta il content type dei dati a "video": 

public void setlmage (byte[] imageData) { 
this. imageData = imageData; 
image = Image.createlmage( 

imageData, 0, imageData. length); 



sendContent 



// content type: immagine } 



public void setVideo(byte[] imageData, byte[] 

videoData) { 



this. imageData = imageData; 



image = Image. createlmage( 

imageData, 0, imageData. length); 



this. videoData = videoData; 



sendContent = V; // content type: video 



} 



contenente un TextField, in cui si inserisce il nome 
del file (massimo 15 caratteri). Al Form viene ag- 
giunto il comando corrispondente ad "Invia" la cui 
azione è: 

if (e == sendDataCommand) { 
switch (sendContent) { 
case V: // image 



data = imageData; 



break; 



case V: // video 



data = videoData; 



break; } 



String fileName = fileNameTF.getString(); 
int numSpace = 15 - fileName. Iength(); 



for (int k=0; k < numSpace; k+ + ) { 



fileName = fileName + 



} 



byte[] fileNameByte = fileName. getBytesQ; 
dataMod = new byte [data. length + 1 + 

fileNameByte. length]; 



dataMod[0] = (byte)sendContent; 



for (int i = 0; i < fileNameByte. length; i+ + ) { 



dataMod[i + l] = fileNameByte[i]; } 



for (int j = 0; j < data. length; j++) { 

dataMod[] + fileNameByte. length + 1] = data[j];} 



sendData (dataMod); 



} 



In entrambi i casi, a questo punto il metodo paint ( ) 
si accorge di avere un'immagine a disposizione e la 
disegna sullo schermo: 

public void paint (Graphics g) { 
g.setColor(OxOOOOFFFF); // cyan 
g.fillRect(0,0,getWidth(),getHeight()); 
if(image != nuli) { 

g.drawImage(image,getWidth(),getHeight(), 

Graphics.VCENTER|Graphics.HCENTER);} 
} 



Anche il funzionamento di questa classe, come di 
CameraCanvas, è basato sulle azioni legate ai co- 
mandi. Alla pressione del tasto corrispondente a "In- 
via al repository" avviene il passaggio alla scherma- 
ta per l'inserimento del nome del file: 

if (e == sendCommand) { 
fileNameTF = new TextField("Salva come...", 

"",15,TextField.ANY); 
saveFileForm = new Form("MobileCamera"); 
saveFileForm.append(fileNameTF); 
saveFileForm.addCommand(backCommand); 
saveFileForm.addCommand(sendDataCommand); 
saveFileForm. setCommandListener(this); 
Display.getDisplay(midlet).setCurrent(saveFileForm); 



In pratica viene costruito e visualizzato un Form 



I dati da inviare non sono soltanto quelli relativi 
all'immagine o al video. In un array di byte viene 
infatti inserito come primo byte il carattere identifi- 
cativo del content type ("i" per immagine oppure "v" 
per video), quindi il nome del file destinazione e poi 
il contenuto vero e proprio. Infine, finalmente i dati 
vengono spediti, attraverso il metodo sendData 
(byte[] data). Supponiamo di trasferire i dati tramite 
socket. Otteniamo un oggetto SocketConnection 
utilizzando il metodo Connector.open (String uri). 
La sintassi della uri deve essere conforme alla se- 
guente: "socket: //hostport". Ora che abbiamo a di- 
sposizione una connessione ci occorre un canale su 
cui scrivere i dati: si tratta di uno StreamConnection. 
Vediamo l'implementazione: 

void sendData (byte[] data) { 

try { 

socketConn = (SocketConnection)Connector.open( 

"socket://88.88.88.88:88"); 

midlet.displayAlert("Attendere... trasferimento in 

corso!"); 
se = (StreamConnection) socketConn; 
dos = sc.openDataOutputStream(); 



dos.write(imageData); 



dos.flushQ; 



} catch (IOException ioe) { 



midlet.sendCanvasBack(); 



midlet.displayAlert("Trasferimento impossibile... 
riprovare più tardi");} 
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finally { 



try { 



dos.close(); 



sc.closeO; 



socketConn.close(); 



midlet.sendCanvasBack(); 



midlet.displayAlert("Connessione col server 

chiusa!"); 



} catch (IOException ioe) { 



midlet.sendCanvasBack(); 



midlet.displayAlert("Errore dì comunicazione 

col server!");} } 



REPOSITORY SERVER 

Come repository server si può utilizzare una 
struttura basata sull'application server Apache 
Tomcat. Il server (lo chiamiamo MultimediaRe- 
pository) è composto di due oggetti: la classe 
Repositorylnit che inizializza il server, e la classe 
RequestManager che gestisce le richieste del 
client (invio dati) . 

Repositorylnit legge da file di configurazione 
(MultimediaRepository.ini) informazioni quali la 
porta su cui il server è in ascolto, il path del file di 
configurazione dei log, la directory dei log, la 
directory dove salvare le immagini e quella dove 
salvare i video. Inoltre instanzia un ServerSocket 
sulla porta specificata dal file di configurazione e 
si mette in ascolto di nuove connessioni socket 
stabilite da un client. Infine passa l'oggetto 
Socket, corrispondente ad una nuova connessio- 
ne, al RequestManager: 

ServerSocket serverSocket = new ServerSocket( 

SERVER_PORT); 
//Mi metto in ascolto di chiamate dai client 
while( true ) { 

logger.info("Server in attesa di chiamate da client 

sulla porta " + SERVER_PORT ); 
Socket clientSocket = serverSocket. accept(); 
logger.info("Ricevuta chiamata apertura socket da: 
" + clientSocket. getInetAddress() ); 
RequestManager manageRequest = new 

RequestManager(clientSocket); 
manageRequest. start(); 
logger.info("Avviato thread per gestire la 

chiamata..."); 
} 

Il metodo RequestManager apre un Bufferedln- 
putStream sull'InputStream relativo al Socket 
che gli viene passato e legge i dati. Elaborando i 
dati ricevuti ottiene le informazioni che gli 
occorrono per salvare un'immagine col suo 
nome nella directory relativa alle immagini 



oppure un video col suo nome nella directory 
relativa ai video: 

'-Hf (clientSocket. isClosed()) { 
// content type 

char dataType =(char)byteArrayClient[0]; 
// file name 
String fileName = ""; 




for (int i=l; i <= 15; i ++) { 



fileName += (char)byteArrayClient[i]; } 



// immagine o video 



byte[]data = nuli 



for (int j = 1 6 ; j < byteArrayClient.length; ] ++) { 



data[j-16] = byteArrayClient [j]; } 



String saveDir : 



switch (dataType) { 



case V: // image 



saveDir = Repositorylnit. IMAGE_DIR; 



break; 



case V: // video 



saveDir = Repositorylnit. VIDEO_DIR; 



break; } 



String outputFile = saveDir + File.separator + 

fileName; 
FileOutputStream os = new 

FileOutputStream(outputFile); 



os.write(data); 



os.flush(); 



CONCLUSIONI 

In questo articolo abbiamo visto come poter realiz- 
zare un repository dei contenuti multimediali cattu- 
rati con proprio telefono. È un'utile applicazione 
che ci consente, anche con dispositivi non dotati di 
una cospicua memoria (interna o esterna), di poter 
comunque salvare i propri dati. In un prossimo arti- 
colo vedremo come effettuare l'operazione inversa, 
ovvero visionare dal telefono i dati memorizzati su 
un server e scaricare quelli desiderati. 

Vincenzo Viola 



CENTRARE LE IMMAGINI 



Se abbiamo specificato una cattura video in cui 
le dimensioni sono diverse da quelle del display 
del telefono, facciamo in modo, nella 
visualizzazione, di centrare e ridimensionare ciò 
che viene ripreso: 




int canvasWidth = getWidthQ; 



int canvasHeight = getHeight(); 



int displayWidth = videoControl.getDisplayWidth(); 



int displayHeight = videoControl.getDisplayHeight(); 



int x = (canvas Width-displayWidth)/2; 



int y = (canvasHeight-displayHeight)/2; 



videoControl.setDisplayLocation(x,y); 
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Quando PHP 
incontra Java 

Utilizzare le classi Java direttamente da script PHP. Perché farlo? 
Prima di tutto per estendere il linguaggio, secondo per consentire a 
chi conosce Java di riutilizzare le proprie classi anche sul web. Terzo. 




L 



a notizia è di quelle che scottano: Zend 
e Sun hanno annunciato di collaborare 
all'integrazione di Java con PHP. 
L'annuncio risale già a qualche tempo fa, ma 
solo adesso si iniziano a vedere i primi frutti 
della nuova strategia di collaborazione. 
Che cosa vuol dire integrare Java in PHP e 
quali sono i vantaggi che questa integrazione 
potrebbe offrire? La prima risposta è abba- 
stanza semplice. Il frutto di questa integrazio- 
ne è il poter utilizzare le classi e gli oggetti 
Java da dentro PHP come se fossero oggetti 
nativi del linguaggio. La risposta alla seconda 
domanda potrebbe essere più articolata e 
complessa, i vantaggi sono davvero moltissi- 
mi. Prima di tutto, i programmatori Java pos- 
sono tranquillamente riutilizzare il loro lavo- 
ro direttamente sul web senza passare da un 



server JSP, ma utilizzando tutti i vantaggi di 
PHP che attualmente è forse il linguaggio più 
versatile per quanto riguarda le applicazioni 
Internet Oriented. Il secondo vantaggio im- 
mediato è relativo agli sviluppatori PHP che 
possono sfruttare l'alta integrazione di Java 
con i sistemi su cui gira una JVM. Qualche 
esempio? Potreste sviluppare un'applicazione 
Web che consente ad un utente di immettere 
un testo e un numero di telefono, la pressione 
del tasto "submit" richiama una classe java 
che sfrutta HylaFax per mandare un fax. Si 
potrebbe fare lo stesso con gli SMS per esem- 
pio. Java si può porre come collegamento fra 
Internet e l'hardware di una macchina. 
Oppure ancora è possibile sfruttare la potenza 
di J2EE, tutto ciò che è possibile fare con Java 
estende ora le possibilità di PHP. Per certi 



n 




REQUISITI 



/il basi di PHP 



, Apache, PHP, 
PHP Java Bridge 



E 



l_ 



Tempo dì realizzazione 



COME INIZIARE 



Ovviamente dovete avere sul 
computer una versione funzio- 
nante di Apache o US con PHP. 
Gli esempi di questo articolo 
sono stati testati su una mac- 
china Linux con Apache 1.3, 
PHP 5 e l'estensione Java Brid- 
ge attiva. Per installare Java 
Bridge su Windows è necessa- 
rio scaricare il file php-java- 
bridge * -win32-php5.zip da 
http://sourceforqe.net/projects 



/php-java-bridqe. o prelevarlo dal 



CD allegato alla rivista. Il file 
deve essere scompattato nella 
directory di PHP. Per avviare il 
bridge basta un doppio click su 
c:\php5VavaBridge.jar. 
Per collegare PHP al Java Bridge 
bisogna copiare i Jar e php 
java.dll nella directory delle 
estensioni, infine nel php.ini 



devono essere presenti le 
seguenti righe: 

extension = phpjava.dll[java] 
java. hosts="127. 0.0. 1:9167" 

In ambiente Linux l'estensione 
può e deve essere compilata 
dai sorgenti, scaricando il tgz 

da http://sourceforqe.net/proiects 
/php-java-bridge. http://sourceforge 
.net/projects/php-java-bridqe 
Per la compilazione bisogna 
scompattare i sorgenti e usare 

phpize && ./configure — 
with-java=/opt /IBMJava2-14 && 

make CFLAGS="-m32" 

su -e 'make instali' 
<password> 

Nel php.ini bisogna aggiungere 



extension = java.so[java] 
java.socketname=/var/run 

/.php-java-bridge_socket 

per lanciare il Java Bridge 

export JAVA_HOME=/usr/lib 

/sun-j2sdkl.5.0 

export LD_LIBRARY_PATH=/usr 

/Iib/php5 /20041030/usr/lib 

/php5/20041030/RunJavaBridge 

/usr/lib/sun-j2sdkl.5.0/bin/java 

-Djava.library.path=/usr/lib/php5 

/20041030 -Djava. class. path = 

/usr/lib/php5/20041030/JavaBridge 

.jar -Djava. awt.headless=true 

php.java. bridge. JavaBridge /var 

/run/.php-java-bridge_socket 2 " 

sostituite ovviamente i path 
usati nell'esempio con quelli 
relativi alla vostra installazione 
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versi in questo senso Java potrebbe essere 
quello che il .NET framework è per ASP .NET. 



PHP5 VS PHP4 



C'è una certa 
confusione nell'uso 
delle estensioni Java 
per PHP. Fino alla 
versione 4, infatti, la 
dll o il .so che le 
rende utilizzabili 
erano distribuite in 
bundle con PHP. Se 
usate PHP4 avrete 
ancora java. dll 
disponibile e potrete 
utilizzarla abbastanza 



semplicemente 
decommentando le 
righe relative nel 
php.ini. Dalla 
versione 5 di PHP, le 
estensioni java non 
sono più Bundled con 
PHP, tutto ciò rende 
necessario i passi di 
installazione che 
abbiamo illustrato in 
questo stesso 
articolo. 



LE MANI NEL CODICE 

Non c'è niente di meglio che un bell'esempio 
per cominciare. Ovviamente inizieremo da 
qualcosa di semplice: 



all'indirizzo http://localhostfjaval.php, otten- 
go il seguente output 

Java version-1.5.0_01 
Java vendor=Sun Microsystems Inc. 
OS=Linux 2.6.10-5-386 on Ì386 
giovedì, aprile 14, 2005 at 3:59:53 PM Ora esti- 
va dell'Europa centrale 

informazioni tipiche di Java. 



DOVE JAVA ? 

L'esempio che abbiamo appena visto lascia 
intuire la potenza del sistema, perché ci ha 
consentito di utilizzare classi messe a disposi- 
zione del framework J2SE 1.5.0 direttamente 
da PHP, ma non è ancora sufficientemente 
interessante. Un buon programmatore Java 
progetta delle classi, e vorrebbe poi riutiliz- 
zarle sia per le proprie applicazioni standalo- 
ne sia per il web. 
Consideriamo la seguente classe java 





I TUOI APPUNTI 



<?php 



import java.util.LinkedList; 



$system = new Java('java.lang. System'); 



echio 'Java version = 



$system->getProperty( 

'java.version') . '<br/>' 



echio 'Java vendor= 



$system->getProperty( 

'java.vendor') . '<br/>' 



echio 'OS=' . $system->getProperty('os.name') . ' ' . 
$system->getProperty('os.version') . ' on ' . 
$system->getProperty('os. anch') . ' <br/>'; 
$formatter = new Java('java.text.SimpleDateFormat', 

"EEEE, MMMM dd, yyyy 'at' h:mm:ss a zzzz"); 
echo $formatter->format(new Java('java.util.Date')); 



?> 



La prima riga instanzia un oggetto system di 
classe java.lang.system. A questo punto stia- 
mo già utilizzando la JVM e le classi di java, 
non ci resta che richiamare metodi e proprie- 
tà tipiche della classe che stiamo usando. 
L'esempio è abbastanza chiaro, si usa il meto- 
do getProperty per ottenere le informazioni di 
sistema. Da notare che il comando echo è in- 
vece un comando PHP. $system è un oggetto 
che fa riferimento alla classe Java, ma all'in- 
terno di PHP viene utilizzato come un oggetto 
nativo. Nelle righe che seguono l'esempio re- 
lativo ai dati di sistema, viene instanziato in- 
vece un oggetto formatter di classe java.text- 
SimpleDateFormat e successivamente la data 
viene stampata a schermo tramite il comando 
echo. 

Salvando questo file, come javal.php nella ra- 
dice del mio webserver e puntando il browser 



import java. util. List; 



public class phptest{ 



public List calcolaNumeriPrimi(int da, int a) 



{ 



List risultato = new LinkedList(); 



for(int i = da; i <= a; i++) 



if(numeroPrimo(i)) 



risultato. add(new Integer(i)); 



return risultato; 



private boolean numeroPrimo(int n) 

i 

for(int i = 2; i <= Math.sqrt(n); i+ + ) 



if(n % 



0) 



return false; 



return true; 



Utilizza questo spazio 
per le tue annotazioni 



public static void main(String[] args) 

{ 

phptest p = new phptestQ; 



if(args.length 



0) 



{ 



System. out.println("errore - devi fornire due 

numeri"); 



} else 



try 
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int arg2 


= Integer.parselnt(args[l]); 




int argl 


= lnteger.parselnt(args[0]); 




System. 


Dut.println(p. calcola NumeriPrimi( 

argl,arg2)); 




} catch(N 


jmberFormatException e) 


{ 




System 


out.println("errore - devi fornire 

due numeri"); 


} 


} 


} 


} 



Si tratta dell'onnipresente classe per il calcolo 
dei numeri primi. Ce ne ha parlato anche Pao- 
lo Perrotta nel suo articolo sui Thread presen- 
te in questo stesso numero. In questo esem- 
pio l'abbiamo leggermente semplificata, ma 
nulla vieta che possiate aumentarne la com- 
plessità utilizzando i thread come nell'artico- 
lo in questione. Per i nostri scopi andrà benis- 
simo questa versione. 

Come vedete la classe in questione espone 
solo il metodo calcolaNumeriPrimi(int da, int 
a) che riceve in input due interi, a questo 
punto esegue un ciclo partendo dal primo nu- 
mero e incrementando fino all'ultimo e per 
ogni ciclo verifica se il numero in corso è un 
numero primo o no. Se lo è lo aggiunge ad una 
Lista dichiarata di classe List. La verifica è affi- 
data al metodo dichiarato private numeroPri- 
mo(int n) che esegue i suoi calcoli e restitui- 
sce un valore booleano. Il main è strutturato 
in modo che debbano essere forniti due para- 
metri all'applicazione, i due parametri vengo- 
no convertiti da stringhe a numeri e passati al 
metodo calcolaNumeriPrimi(int da, int a) 
infine viene stampata a video la lista restituita 
dal metodo. Non si tratta certo di una classe 
complessa. Ma è importante notare che si 
tratta di una classe java che a sua volta usa 
altre classi java in particolare i package .util 
ad esempio. Possiamo salvare il codice come 
phptest.java e compilare con javac -Xlint 
phptest.java e eseguirla con java phptest. 
Ovviamente la classe si comporta esattamen- 
te come ci si aspetta, se non passiamo nessun 
parametro o dei parametri che ricalcano dei 
valori non numerici restituisce un errore, vi- 
ceversa restituisce l'elenco dei numeri primi 
contenuti nell'intervallo. Ad esempio java 
phptest 10 20 restituisce: [11, 13, 1 7, 19] 



norma di comportamento. In questo caso uti- 
lizziamo un solo file e una sola classe. Ma se ci 
muovessimo in ambiti più complessi avrem- 
mo molti file di classi e sarebbe indispensabi- 
le generare un ,rar che li contiene. 
Il comando è banale: jar cvf phptest. jar phpte- 
st. class, copiamo il jar appena generato in un 
qualche directory del nostro hard disk e pas- 
siamo al nostro file php. 



$here = trim('pwd"); 
java_set_library_path("$here/phptest.jar"); 



$numeri = new java("phptest"); 



$a = 5; 



$b=20; 



foreach ($numeri->calcolaNumeriPrimi($a,$b) 

as $value) 



{ 



print($value)."<br>" 



?> 



In questo spezzone di codice ci sono diverse 
cose decisamente interessanti. Non conside- 
riamo ovviamente la prima riga che ci resti- 
tuisce semplicemente il percorso attuale. La 
seconda riga è già più utile, definisce il per- 
corso della libreria che andremo a utilizzare: 
java_set_library_path("$here/php test, jar"); 
potremmo anche saltare questa istruzione, 
ma in tal caso la libreria dovrebbe essere rag- 
giungibile nel ClassPath del sistema. Nella se- 
conda riga si instanzia un oggetto di classe 
phptest. Da notare che è la classe che abbiamo 
definito in precedenza. 

Infine, usiamo il metodo calcolaNumeriPrimi 
($a,$b) direttamente da una sezione di forea- 
ch. In questa ultima istruzione è utile mostra- 
re come il passaggio dei parametri avvenga 
tramite le variabili $a e $b che sono proprie di 
php. 



UHI PO' DI INTERAZIONE 

Se siete un minimo esperti di PHP o di Web 
avrete già intuito che in questo paragrafo ag- 
giungeremo alla nostra applicazione una 
form, per far sì che l'utente possa inserire da 
solo i due numeri che compongono il range 
da testare. Il codice è il seguente: 



USIAMOLA DA PHP 

Prima di tutto, è bene creare un jar delle 
nostre classi. Non è una regola, ma una buona 



<form action = "java4.php method = post> 
Valore 1: <input type=text name=axbr> 
Valore 2: <input type=text name=bxbr> 
<input type=submit> 
</form> 
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<? 


$here = trim( 


pwd' ); 




java_ 


_set_libra 


"y_path("$here/phptest.jar"); 




$numeri = new java("phptest"); 


if($_ 


_POST['a'; 


!=" and $_POST['b']! = ") 




{ 


foreach ($numeri->calcolaNumeriPrimi( 

$_POST['a , ],$_POST[ , b']) as 


$value) 


{ 


print($value)."<br>"; 


} 


} 


?> 



Anche in questo caso il codice è estremamen- 
te comprensibile. Il passaggio dalla forni a 
PHP avviene come di consueto tramite un 
POST, i parametri vengono passati all'oggetto 
Java tramite una normale interrogazione al- 
l'array $_POST. Un if verifica che le due varia- 
bili passate al metodo calcolaNumeriPrimi 
non siano delle stringhe vuote, onde evitare 
errori a runtime. Ovviamente si potrebbe mi- 
gliorare il tutto effettuando i controlli sull'in- 
put, e qui c'è già da decidere se la validità sul 
formato dell'input deve essere effettuata 
direttamente da PHP o può essere delegata 
nella definizione del metodo calcolaNu- 
meriPrimi. Nel primo caso saranno i program- 
matori PHP a intervenire, nel secondo i pro- 
grammatori Java. 



UM PO' DI COMMENTI 

Spulciando nella documentazione relativa a 
"Java Bridge", ovvero l'estensione che stiamo 
usando per realizzare queste tecniche, si tro- 
vano alcuni esempi interessanti. Alcuni sono 
addirittura relativo all'uso di J2EE ma, al di là 
di questi, ce n'è uno che contiene alcuni pezzi 
di codice che offrono spunti di riflessione. Si 
tratta di una miniapplicazione PHP che sfrut- 
ta una classe Java per creare dinamicamente 
un foglio Excel e salvarlo sull'Hard Disk. 
Questo esempio in particolare ci sembra in- 
telligente, perché in condizioni normali per 
creare un foglio di calcolo Excel via PHP do- 
vremmo instanziare un oggetto COM e utiliz- 
zarne i metodi. La tecnica, per quanto docu- 
mentata, non è esattamente un mostro di sta- 
bilità. Più di una volta si ottengono vistosi 
crash dell'applicazione, senza contare che per 
instanziare un oggetto COM il nostro PHP de- 
ve girare sotto Windows, e questo ovviamente 
sacrifica una parte importante dell'usare PHP, 
ovvero il suo essere multipiattaforma. 



Viceversa integrando PHP con alcune classi 
java che manipolano direttamente i file Excel, 
tutto funziona a meraviglia anche sotto Linux 
e l'affidabilità è molto elevata rispetto a quel- 
la offerta dall'uso degli oggetti com. 
Dando uno sguardo al codice troviamo: 

java_set_library_path("$here/exceltest.jar;http://php 
-java-bridge.sf.net/poi.jar"); 
$excel = new java("ExcelTest"); 

Il che è decisamente interessante. Notate in- 
fatti che la classe "poi.jar" viene invocata in 
modo remoto. Non è locale al computer dove 
risiede il web server, ma a sua volta è esposta 
su un web server su internet. 
Il resto dovrebbe essere ormai abbastanza no- 
to. Si potrebbe discutere su come interna- 
mente la classe in questione e gli esempi rela- 
tivi realizzano il loro scopo, ma non è chiara- 
mente l'oggetto di questo articolo. 



CONCLUSIONI 

Ci sono altre considerazioni da fare sull'uso di 
questa tecnica. In particolare vogliamo farvi 
notare che la classe phptest poteva anche 
essere implementata come runnable e questo 
avrebbe fatto sì che da php l'intero calcolo 
potesse essere eseguito in un Thread, con evi- 
denti vantaggi per la velocità. Un esempio di 
come richiamare il thread da PHP potrebbe 
essere il seguente: 

$Thread = new JavaClass("java.lang.Thread"); 
$Thread->start: 

Ovviamente questo richiede degli accorgi- 
menti. In questo stesso numero di ioProgram- 
mo, Paolo Perrotta ci illustra appunto come si 
possano usare i thread in Java. 
Chiaramente poiché PHP pur girando lato 
server proietta il suo Output su un browser, 
bisogna tenere conto del tempo che il browser 
impiega per renderizzare la pagina. Tuttavia 
in molti casi l'uso dei thread può velocizzare 
anche di molto un'applicazione. 
Fino ad oggi questa tecnica non era stata 
applicata con frequenza, a causa di una certa 
debolezza dell'intero meccanismo, che pote- 
va portare a qualche crash applicativo. La col- 
laborazione fra Zend e Sun ha già molto 
migliorato questo aspetto rendendo il sistema 
decisamente più stabile. C'è ancora qualche 
passo da compiere prima di poter dire che 
tutto è perfetto, tuttavia ci sentiamo di affer- 
mare che la strada intrapresa è quella giusta. 





SUL WEB 



http://php-java-bridqe 
.sourceforge.net/ 

http://it2.php.net/manual 
/en/ref.java.php 
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Creare interfacce 
Java con XML 

Un metodo molto interessante per separare la logica dell'interfaccia 
da quella dell'applicazione. La novità è che utilizzeremo un file esterno 
in formato XML per definire completamente la grafica di presentazione 




□ CD □ WEB 

Thinletzip 



"^ 



z'^r 7 ^ ''■'■ ■' 



in 




REQUISITI 



Qj| Basidi Java 



Basi di XML 

. Java JSDK 1.4 o 
superiore, Thinlet 



Tempo di realizzazione 



Thinlet è una libreria lava open source distri- 
buita con licenza LGPL che permette di man- 
tenere una netta separazione tra l'interfaccia 
e la logica applicativa grazie alla possibilità di legge- 
re la definizione della GUI da file XML. Ogni compo- 
nente, come bottoni e campi, dispone di una serie di 
proprietà quali visibilità e abilitazione settabili sia da 
XML che programmaticamente a runtime. Inoltre 
ogni componente genera una serie di eventi in fun- 
zione delle azioni compiute dall'utente su di esso. 
Ad ogni evento è possibile associare un metodo lava 
che definisce quale sarà l'azione corrispondente. 
Un'interfaccia grafica sviluppata con Thinlet è un 
albero di oggetti grafici. Ad esempio un "panel", che 
è l'elemento principale, può contenere una "label" 
per la visualizzazione di un testo generico, una "tex- 
tarea" per l'immissione di un testo lungo ed una 
"table" per elencare dei risultati. La classe Thinlet è 
in grado di restituire per ogni elemento grafico del- 
l'interfaccia un'istanza di Object da utilizzare come 
"handle". L'impostazione delle proprietà dei compo- 
nenti grafici è quindi delegata a Thinlet, che setta la 
proprietà dell'oggetto grafico a cui corrisponde 
l'handle passato come parametro. Come esempio, 
per impostare la proprietà "enabled" di un compo- 
nente "button" si dovrà richiamare un metodo di 
Thinlet che imposta la proprietà del bottone pas- 
sando l'handle dello stesso. Ad esempio: 

Object buttonHandle = thinlet. create("button"); 
thinlet. setBoolean(buttonHandle, "enabled", true); 



COME INIZIARE 

Create una directory con nome "ThinletDemo" con 
tre sottodirectory: "src" dove troveranno posto i sor- 
genti lava, "build" 'utilizzata per memorizzare le clas- 
si compilate e "lib" dove sarà posizionato il file jar 
contentente la libreria Tliinlet. Collegatevi al sito 



www.thinlet.com, dalla sezione "download" scarica- 
te il file zip più aggiornato che al momento di scri- 
vere l'articolo è "thinlet-2004-03-07-zip" e che con- 
tiene la documentazione ed il file jar della libreria. 
Scompattate lo zip e copiate il file "thinlet.jar" nella 
directory "lib" creata precedentemente. Oppure uti- 
lizzate direttamente il file che troverete nel ed alle- 
gato ad ioProgrammo. 



DEFINIZIONE 
DELL'INTERFACCIA 

Creiamo un nuovo file "ToDoThinlet.xml" nella car- 
tella "src" che conterrà la definizione dell'interfaccia 
principale dell'applicazione. Tale file definisce un 
pannello nel quale il primo componente è la barra 
dei menu con l'unica voce "Tasks" che da accesso 
alla voce di menù per la creazione di un nuovo task. 
Alla voce di menu associamo l'event handler che 
aprirà la finestra di dialogo per l'inserimento di un 
nuovo task. Similmente il bottone provocherà l'in- 
vocazione del metodo taskDoneO nel caso venga 
premuto. 

<panel columns="l" gap="5" top="5" bottom = "5" 

left="5" right="5" columns="l" weighty="l"> 
<!-- barra dei menu — > 
<menubar weightx="l"> 
<menu text="Tasks"> 
<menuitem text="New event..." action = 

"showNewEventDialog()"/> 
</menu> 
</menubar> 

<!-- tabella per l'elenco dei task da eseguire --> 
<table name="toDoTable" weighty="l"> 
<header> 

<column text="Task"/> 
</header> 
</table> 
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<!— tasto per l'evasione del task — > 



public static final int LOW=-l; 



<button text="done" weightx="l" 



action = 

"taskDone()"/> 



</panel> 



ETJToDo list 



d*! 



Task 



HIGH - Preparare slide per riunione 
HIGH - Scadenza bolletta gas 
NORMAL- Chiamare Susanna per la festa 
NORMAL- Preparare articolo per ioProgran 
NORMAL- Ritirare la merce presso il punto 
NORMAL- Telefonare al commercialista 
LOW- Chiamare Gigi 
LOW- Scade l'ahhonamento alla biblioteca 



done 



Nuovo task 



Urgents 



priority 



High 



cancel OK 



a 



Fig. 1: Ecco come appare l'interfaccia della nostra 
applicazione 

Passiamo ora alla definizione del file XML che speci- 
fica l'aspetto grafico della finestra di dialogo per l'in- 
serimento di un nuovo task. Qui troviamo due event 
handler, uno per la chiusura della finestra di dialogo, 
l'altro per la creazione del nuovo task. In questo caso 
l'elemento root non è "panel" ma "dialog" ad indica- 
re che quello che si sta definendo andrà visualizzato 
come una finestra flottante all'interno dell'applica- 
zione. L'attributo "modal" impostato a "true" specifi- 
ca che non è possibile agire sull'applicazione sotto- 
stante sino a che la finestra di dialogo non è chiusa. 



<dialog modal = "true" columns="3" text= 



"Nuovo task"> 



<label text="task" colspan = "3"/> 



<textfield name="description" colspan = "3"/> 
<label text="priority" colspan = "3"/> 
<combobox name="priority" colspan="3"> 
<choice text="High"/> 
<choice text="Normal"/> 
<choice text="Low"/> 
</combobox> 
<button text="cancel" colspan = "2" action = 

"closeNewEventDialog()"/> 
<button text="OK" action = "newTask( 

description.text,priority.selected)"/> 
</dialog> 
La classe Task 

La classe Task rappresenta l'oggetto principale trat- 
tato dall'applicazione. Un task ha la responsabilità 
di conoscere la propria descrizione e la propria prio- 
rità. Inoltre la classe implementa l'interfaccia Com- 
parable in modo che le Collection di Task potranno 
essere facilmente ordinate in base alla priorità. 

public class Task implements Comparable{ 
public static final int HIGH = 1; 
public static final int NORMAL=0; 



private String description; 



private int priority; 



public Task(String description, int priority) {...} 



public String getDescription() {...} 



public int getPriority() {...} 



public String toString(){...} 



public int compareTo(Object o) { 



if(o instanceof Task){ 



Task t = (Task)o; 



if(getPriority()!=t.getPriority()) 



return t.getPriority() - getPriority(); 



return getDescription().compareTo( 

t.getDescription()); } 
throw new ClassCastException("not a task"); } 



L'APPLICAZIONE 

La classe importa il package thinlet ed estende la 
classe Thinlet. Sono definiti come attributi gli hand- 
le dei componenti grafici dell'interfaccia e l'array list 
che conterrà i task inseriti. Il costruttore si occupa di 
caricare i file XML che definiscono la finestra princi- 
pale e la finestra di dialogo, memorizzando gli op- 
portuni handle. 

import [...]; 
import thinlet.Thinlet; 
public class ToDoThinlet extends Thinlet{ 
//task da visualizzare 
private ArrayList tasks; 
private Object toDoWindow; 
private Object toDoDialog; 
private Object toDoTable; 
private Object prioritiField; 
private Object descriptionField; 
public ToDoThinlet(){ 

tasks = new ArrayListfJ; 
//caricamento interfacce xml 

try { 

toDoWindow = parse("ToDoThinlet.xml"); 
toDoDialog = parse("ToDoDialog.xml"); 
} catch (IOException e) { 

throw new RuntimeException(e); } 
toDoTable = find(toDoWindow, "toDoTable"); 
prioritiField = find(toDoDialog, "priority"); 
descriptionField = find(toDoDialog, "description"); 
//aggiunta della finestra di dialogo 
add(toDoWindow); 
} 



Il primo metodo è il metodo updateQ che ha la re- 
sponsabilità di creare la tabella con l'elenco di task 
inseriti. I metodi che creano e rimuovono Task invo- 
cheranno prima della loro conclusione updateQ in 
modo da ottenere l'aggiornamento dell'interfaccia. 




EDITOR 

DI THINLET 

Potete trovare ai 
seguenti indirizzi due 
editor per sviluppare 
interfacce con Thinlet. 
Entrambi permettono di 
creare l'interfaccia ed 
esportare poi l'XML 
equivalente. 
Il primo, ThinG è un 
editor open source GPL 
mentre del secondo, 
Theodore, esistono una 
versione freeware ed 
una versione a 
pagamento. 
http://thina.sourceforqe.net/ 



http://www.carlsbadcubes 
.com/theodore/ 




I TUOI APPUNTI 



Utilizza questo spazio per 
le tue annotazioni 
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EDITOR 
DI THINLET 

Non è necessario indi- 
care un DOCTYPE per gli 
XML di definizione 
dell'interfaccia. Tutta- 
via se avete un editor 
XML in grado di auto 
completare il codice, la 
definizione del DOCTY- 
PE vi permette di rice- 
vere preziosi aiuti dal- 
l'editor su quali ele- 
menti potete inserire 
all'interno di un ele- 
mento esistente. 



COMPONENTI 

Alcuni dei componenti 

grafici più interessanti 

previsti da Thinlet. 

• "tabbed" pane per la 
suddivisione logica di 

componenti grafici tra- 
mite pannelli identifica- 
ti da linguette 

• "spinbox" per l'impo- 
stazione di valori interi 

attraverso l'utilizzo di 
pulsanti per l'incremen- 
to e decremento del 
valore 
• "progress" bar per 
mostrare l'avanzamen- 
to di un processo di 
elaborazione 
• "slider" per l'imposta- 
zione rapida di valori 
numerici tramite 
cursore 
• "split pane" per per- 
mettere all'utente di 
personalizzare l'inter- 
faccia definendo lo spa- 
zio a disposizione di di- 
versi insiemi di compo- 
nenti 

• "tree" per la visualiz- 
zazione di informazioni 

strutturate. 



La logica è quella di rimuovere tutte le righe even- 
tualmente presenti nella tabella e per ogni task da 
evadere memorizzato nell'attributo di classe, ag- 
giungere una riga con una cella contenente la de- 
scrizione sottoforma di stringa dell'oggetto ottenuta 
mediante toStringO- La prima sezione ottiene l'elen- 
co di tutte gli handle delle righe comprese nella ta- 
bella. Il metodo getltemsO restituisce infatti tutti gli 
handle dei widget grafici contenuti in un compo- 
nente di cui si fornisce l'handle. L'elemento "tablé'b 
costituito da molti componenti "row" a. loro volta co- 
stituiti da componenti "celi". Con un ciclo sugli 
handle ottenuti e attraverso il metodo removeO, ven- 
gono eliminate tutte le righe dalla tabella. A questo 
punto per ogni task presente nell'arrayList, viene 
creato a run time un oggetto row tramite il metodo 
create. Questo metodo accetta come parametro il 
nome di un qualsiasi componente grafico Thinlet, 
così come utilizzato nei file XML, e ne resituisce 
l'handle. Per ogni row viene aggiunta con la stessa 
logica una celi che contiene la descrizione del task 
corrente. Ogni volta sono anche resettati i controlli 
della finestra di dialogo. 

public void update(){ 
//svuotamento tabella 
Object[] rows = getltems(toDoTable); 
for (int i = 0; rows! = null && i < rows.length; 

i++) {remove(rows[i]);} 
//aggiunta di task 



if (tasks != nuli) { 



Object row; 



Object objectCell; 



for (int i = 0; i < tasks. size(); i++) { 



//creazione della riga 



create("row"); 



objectCell = create("cell"); 



setString(objectCell, "text", 

tasks. get(i).toStrìng()); 



add(row, objectCell); 



add(toDoTable, row);} } 



setString(this.descriptionField,"text",""); 
setInteger(this.prìoritiField, "selected", 1); 



} 



Veniamo ora agli event handler. In particolare è si- 
gnificativo l'handler specificato in corrispondenza 
del pulsante per l'inserimento di un nuovo task che 
invocherà il metodo createNewTask passando due 
argomenti. Il primo è la proprietà text del compo- 
nente descrìption che contiene la descrizione del 
task. Il secondo è il valore della proprietà selected 
del componente priority che è la priorità. Il metodo 
crea un nuovo task utilizzando la descrizione e la 
priorità specificate via interfaccia, aggiunge il task 
alla lista da visualizzare e riordina lo stesso con l'op- 
portuno metodo statico sortQ definito nella classe 
java.util.Collections che ci assicura che i task a prio- 



rità maggiore siano in cima alla lista. Viene poi ri- 
chiamato metodo updateO per aggiornare la fine- 
stra. 

// Aggiunge un task alla lista mantenendola ordinata, 
public void createl\lewTask(String description, int 

priori tySelected){ 
int prioriity=Task.LOW; 
if(prioritySelected = = 0){prioriity = Task. HIGH;} 



else if(prioritySelected = 



= l){prioriity = 

Task.NORMAL;} 



else if(prioritySelected ==2){prioriity = Task.LOW;} 
Task task = new Task(description, prioriity); 



this. tasks. add(task); 



Collections.sort(this. tasks); 



closeNewEventDialog(); 



update(); } 



// Marca come eseguito il task selezionato, 
public void taskDone(){ 

int index = getSelectedlndex(toDoTable); 

if(index! = -l) tasks. remove(index); 



update(); } 



public void showNewEventDialog(){ 



add(toDoDialog); } 



public void closel\lewEventDialog(){ 



remove(toDoDialog); 



} 



Oltre al costruttore è necessario un metodo main 
che lanci l'applicazione. Thinlet mette a disposizio- 
ne la classe di supporto FrameLauncher per fare ciò. 

public static void main(String[] args) { 
ToDoThinlet toDo = new ToDoThinlet(); 
FrameLauncher fi = new FrameLauncher( 

"ToDo list", toDo, 500, 300); } 



COMPILARE E LANCIARE 
L'APPLICAZIONE 

Portatevi nella directory "src" dei sorgenti e digitate il 
seguente comando avendo cura di sostituire 
<home> con la cartella del progetto. 

javac -classpath <home>\lib\thinlet.jar -d ..\build 

*.java 

Utilizzate il seguente comando per lanciare l'appli- 
cazione. 

java -cp <home>\lib\thinlet.jar;<home>\build\ 

ToDoThinlet 

Utilizzate il menu per inserire nuovi task ed il pul- 
sante sotto la tabella per evadere i task eseguiti. 

Daniele de Michelis 
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Amici per la pelle 
thread e interfacce 

Avete mai visto quelle interfacce grafiche che si "congelano" 
quando si preme un pulsante? Ecco come evitare questo 
comportamento maleducato grazie ai thread di Java 




□ 



CD □ WEB 

Threads_3.zip 



sfi^Lr ' ' 



in 




REQUISITI 



■W..M.lJ.J.t.'A. 



na | Swing, Thread, 
— synchronized 




^3Li^^3 



Tempo di realizzazione 



Uno dei problemi più comuni nei miei primi 
programmi Java, era quello delle "interfac- 
ce congelate". Queste interfacce si blocca- 
vano ogni volta che programma era impegnato a 
macinare dati. Se un programma faceva solo opera- 
zioni molto brevi, allora non c'era problema. Ma 
quando si trattava di fare lunghi calcoli, o magari di 
collegarsi ad un server remoto, il risultato era terribi- 
le: premevo un pulsante e tutto si bloccava, compre- 
so l'aggiornamento dello schermo. Nei casi migliori, 
l'interfaccia era lenta come un bradipo; nei peggio- 
ri, finivo per chiedermi se il programma non fosse 
semplicemente andato in crash. 



IL CALCOLO 

DI NUMERI PRIMI 

Voglio scrivere un programma che permette di sele- 
zionare un valore iniziale e uno finale, e calcola tutti 
i numeri primi compresi tra i due valori. Eccone una 
prima versione, ancora incompleta: 

import java.awt.*; 

import java.util.*; 

import javax. swing.*; 

public class NumeriPrimi extends JPanel { 

private final JTextArea _output = new JTextArea(); 
// Per visualizzare i risultati 
private final JSpinner_da = new JSpinner(); 

// Il numero iniziale... 
private final JSpinner _a = new JSpinner(); 

// ...e quello finale 
private final JButton _ok = new JButton("OK"); 

// Per lanciare il calcolo 
public NumeriPrimi() { 
inizializzaGUI(); 

// inizia il calcolo quando l'utente preme il pulsante 
_ok.addActionListener(new Action ListenerQ { 
public void actionPerformed(ActionEvent ev) { 
calcolaNumeriPrimi( );}});} 



private void calcolaNumeriPrimi() { 



_ok.setEnabled(false); // Disabilita il pulsante 
_output.setText(""); // Cancella i risultati 

precedenti 



// Calcola! 



List numeri = calcolaNumeriPrimi(((Integer) 

_da.getValue()).intValue(), ((Integer)_a 
.getValue()).intValue()); 



// Stampa i risultati 



for(Iterator i = numeri. iterator(); i.hasNextQ;) 

_output.append(i.next() + "\n"); 
_ok.setEnabled(true); // Abilita il pulsante} 
private List calcolaNumeriPrimi(int da, int a) { 
return new LinkedList(); // FIXME: Per ora non 

fa niente} 
// Piazza i componenti sul pannello 
private void inizializzaGUI() { 
setLayout(new BorderLayout()); 
add(new JScrollPane(_output), 

BorderLayout. CENTER); 
JPanel input = new JPanel(new GridLayout(3, 2)); 
input. add(new JLabel("Da:")); 
input. add(_da); 
input. add(new JLabel("A:")); 
input. add(_a); 
input. add(new JLabel("")); 
input. add(_pk); 

add(input, BorderLayout. SOUTH);} 
public static void main(String[] args) { 
JFrame f = new JFrame("Numeri primi"); 

// Crea la finestra 
f.getContentPane().add(new Numeri Primi()); 

// Mettici dentro il pannello 
f.setSize(640, 480); // Imposta le dimensioni 
f.setDefaultCloseOperation(JFrame 

.EXIT_ON_CLOSE); // Esci dal programma 
quando si chiude la finestra 
f.setVisible(true); // Visualizza il bellissimo 

risultato} 
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i Numeri primi |_ ||I""I||X| 


3 

5 

7 

11 

13 

17 

19 

23 

29 

31 

37 


a 


3 


- 




40 


T 1 




OK 



F/g. 1: la finestra che 
mostra i numeri primi 



Il programma è tutto 
contenuto in un 
JPanel. Il mainQ crea 
un'istanza del JPanel, 
lo mette in una fine- 
stra (un JFrame) e lo 
visualizza. Non ho 
ancora scritto codi- 
ce che calcola i nu- 
meri primi; abbiate 
pazienza, mi sono 
concentrato sull'in- 
terfaccia. Il risultato è 
quello che si vede 
nella Figura 1: un 
paio di spinner (vedi 
box: "Spinner') per impostare numero iniziale e 
quello finale, un pulsante per calcolare i risultati e 
un'area di testo per mostrarli. 
Il costruttore dispone tutti i componenti grafici sul 
pannello e collega il pulsante al metodo calcolaNu- 
meriPrimiO- Questo metodo legge il valore iniziale e 
quello finale dagli spinner, lancia il calcolo e stampa 
i risultati nella JTextArea. Dato che sono un pro- 
grammatore previdente, ho disabilitato il pulsante 
all'inizio del calcolo e l'ho abilitato nuovamente 
dopo la stampa dei risultati; così evito che l'utente 
possa premerlo più di una volta di seguito (ma sono 
stato troppo ottimista, come vedremo tra poco). 



SEPARARE 
L'INTERFACCIA 

Il mio programma è lungo solo poche decine di ri- 
ghe, ma sta già prendendo una brutta piega. Non mi 
piace l'idea che il calcolo dei numeri finisca nella 



stessa classe che si occupa dell'interfaccia. Il codice 
delle interfacce tende sempre ad essere piuttosto 
complicato, e non voglio mescolarlo con la logica del 
programma. È sempre una buona idea separare le 
classi che si occupano della GUI da quelle che si oc- 
cupano di fare i conti. Quindi scriverò una classe per 
contenere la logica, e farò in modo che NumeriPrimi 
deleghi i calcoli a un'istanza di questa classe. Darò a 
questa nuova classe il no- 
me un po' pretenzioso di 
Server, per sottolineare 
che è lei a fornire i servizi 
alla GUI. Il Server potreb- 
be anche risiedere su un 
altro computer, magari 
su Internet (in questo ca- 
so diventerebbe forse un 
Web Service). Nel mio ca- 
so sarà semplicemente 
un oggetto locale: 





Non molti conoscono 
il termine "spinner", 
ma quasi tutti sanno 
cos'è. È una casella di 
testo speciale, fatta 
apposta per immette- 
re numeri (di solito 
interi). L'utente può 
scrivere il numero 



direttamente nella 
casella, oppure può 
usare le due freccette 
a lato della casella 
per incrementare/de- 
crementare il valore. 






public class Server { 



public List calcolaNumeriPrimi(int da, int a) { 



List risultato = new LinkedList(); 



for(int i = da; i <= a; i++) 



if(numeroPrimo(i)) 



risultato. add(new Integer(i)); 



return risultato;} 



private boolean numeroPrimo(int n) { 



for(int 



Math.sqrt(n); i+ + ) 



if(n % 



0) 



return false; 



return true;} 



public static void main(String[] args) { 



Server s = new ServerQ; 



List primi = s.calcolaNumeriPrimi(3, 1000); 
for(Iterator i = primi. iterator(); i.hasNext();) 



UNA SESSIONE DI DEBUG CON ECLIPSE 



IMPOSTARE I BREAKPOINT 



MODALITÀ DI DEBUG 



VEDIAMO I RISULTATI 



public Xune ri Primi [Server si 

_server = s; 

inizializzaGOl{) ; 

_ok. addAc ti onLis tener (new AetionLis'u-en 

public void actionPerformed (fiction 

: ;. _ :oL 5^" une:: i-Primi () ; 



Toggke Breakpoint 
Dsable Breakpoint 
Breakpoint Properties... 



Goto Annotatori 
Team 
Compare With 

Replace With 



Add Bookmark... 



leriPrimi {} ( 
le); 

r er. calcolaNnmeriPri 
oneri, itera tor [) ; 
nextO + "\n") 



DApri con Eclipse una qualsiasi ver- 
sione del programma NumeriPrimi. 
Vai nel metodo actionPerformedQ. Clicca 
con il tasto destro a sinistra della riga di 
codice. Apparirà un menu contestuale. 
Scegli Toggle Breakpoint per inserire un 
breakpoint, segnalato da un pallino 
azzurro: il programma si fermerà su 
questa riga durante il debugging 



Cr concurrency 
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► import java . awt . BorderLayc-ui 

■^public class MumeriPrimi e* 

private final Server _s 
private final JTextArea 
private final JSpinner 
private final JSpinner 
private final JButton 

i(Serv 



Open With 

Open Type Hierarchy 



Nel Package Explorer clicca con il 
tasto destro sul nome della classe 

e scegli Debug -> Java Application. 

Il programma NumeriPrimi partirà in 

modalità debug. 

Mentre il programma gira, clicca sul 

tasto OK per far eseguire il metodo 

actionPerformedQ. Il programma si 

fermerà 



u[> 



H-ffl NumeriPrimi [Java Appltation] 

F" ó% ff.òprogrammo.threads3.5enzathread. NumeriPrimi ai bcalhost: 1590 
& Thread [AWT-Shutdown] (Running) 
,£ Thread [AWT-Windows] (Running) 
"i ±5 Thread [AWT-EventQueue-u] [Suspended (breakpoint at [ne 31 in Nu 

= m/!rs9.im.ri--jia!i'i*..w3S!u w*ii 

= ]Button(AbstractButton).flreAcrjonPerformed(ActDnEvent) tne: 17! 

= AbstractButton$ForwardActDnEvent5.actDnPerformed(ActionEven 

= DefautButtonModel.hreAclionPerformed(AcrjonEvent] Ine: 420 

= DefautButtonModel.5etPre55ed[boolean) line: 258 

= MetalButtonLMener(Ba5k:ButtonlMener].mouseRetea5ed(Mou5eEv< 

= JButton(component).proce55Mou5eEvent(Mou5eEvent) line: 5100 

= JButton(component).proce55Event(AWTEvent) Ine: 4897 

= JButton(container).proce&5Event(AWTEvent) Ine: 1569 

= JButton(component).di£patchEventImpl(AWTEvent) Ine: 3615 



Eclipse dovrebbe avere aperto la 
"prospettiva" di debug. L'istruzio- 
ne sulla quale ti sei appena fermato do- 
vrebbe essere stata chiamato nell'ambi- 
to deìì'AWT EventQueue, cioè la coda de- 
gli eventi del sistema grafico AWT di Ja- 
va. Il thread principale dovrebbe essere 
già terminato: il maini) del programma 
mostra la finestra e termina subito. 
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System. out.println(i.next());}} 

Il Server scopre se un numero è primo con un sem- 
plice algoritmo (vedi box: "Sono contento di essere 
primo"). I numeri primi, convertiti in Integer, fini- 
scono nella lista dei risultati. Il mainO contiene un 
test che calcola e stampa i numeri primi compresi 
tra 3 e 1000. L'ho lanciato. 3,5,7,11, 13... Sì, direi che 
ci siamo. Ora la logica del programma è al suo posto. 



SONO CONTENTO DI ESSERE PRIMO 




Un numero primo è divisibile 
solo per 1 e per se stesso. 
Il modo più semplice per sco- 
prire se un numero n è primo è 
provare a dividerlo per tutti i 
numeri da 2 a n-1: 



private boolean 


numeroPrimo(int n) 


{ 




for(int i = 2; 


i < 


n; i++) 




if(n % i = = 


0) 






return false 


//niente resto; 




// il numero 


e 


divisibile, quindi 


// non è primo 




return true; 


// 


non siamo riusciti 




// a dividere il 


numero. 


quindi è primo 


} 



In NumeriPrimi ho usato un 
algoritmo più efficiente: il ciclo 
delle divisioni va da 2 alla 
radice quadrata di n. 
Si può dimostrare che se non 
troviamo un divisore tra questi 
numeri, non lo troveremo 
nemmeno in seguito (la dimo- 
strazione è facile, e i lettori con 
il pallino per la matematica 
possono provare a trovarla da 
soli). 



private boolean 


numeroPrimo(int n) 


{ 


for(int 


= 2; 


i <= Math.sqrt(n); 

i+ + ) 


// ■■ 


il resto non cambia 



La classe NumeriPrimi potrebbe creare da sola un 
Server a cui delegare i calcoli, ma mi piace di più 
passargli un Server già fatto nel costruttore, in modo 
da poterlo eventualmente sostituire in seguito con 
un'altra implementazione (il famoso Web Service?). 
Ho evidenziato in grassetto le differenze principali 
rispetto alla versione precedente di NumeriPrimi: 

public class NumeriPrimi extends JPanel... 
private final Server _server; 
public NumeriPrimi(Server s) { 



■>} 



private void calcolaNumeriPrimi() { 



_ok.setEnabled (false); 



_o utp ut . setText( "") ; 



List numeri = _server.calcolaNumeriPrimi((( 
Integer)_da.getValue()).intValue(), ((Integer) 
_a.getValue()).intValue()); 
for(Iterator i = numeri. iterator(); i.hasNext();) 
_output.append(i.next() + "\n"); 



_ok.setEnabled(true);} 



private void inizializzaGUI() { 



■>} 



public static void main(String[] args) { 
JFrame f = new JFrame("Numeri primi"); 



Server s = new ServerQ; 



f.getContentPane().add(new NumeriPrimi(s)); 



f.setSize(640, 480); 



f.setDefaultCloseOperation( 

JFrame. EXIT_ON_CLOSE); 
f.setVisible(true);}} 

Così mi piace di più. Ora che ho soddisfatto il mio 
senso estetico posso lanciare il programma, scrivere 
due numeri negli "spinner" e premere il pulsante. 
Ecco i risultati. Sembra tutto molto bello... finché 
non provo a fare qualche calcolo un po' più pesante. 
Ho chiesto al programma di calcolare i numeri primi 
tra dieci milioni e quindici milioni. I risultati non so- 
no poi tantissimi, perché i numeri primi sono una 
vera rarità a queste quote. Ma come si può immagi- 
nare, il povero Server impiega un po' di tempo per 
fare tante divisioni: il mio Pentium a 3GHz richiede 
una quarantina di secondi per arrivare alla stampa 
dei risultati. La cosa seccante è che durante questo 
tempo, il programma sembra morto. Le barre di 
serali e gli spinner non funzionano. Se riduco le di- 
mensioni della finestra e poi la ingrandisco di nuo- 
vo, il sistema non aggiorna nemmeno la visua- 
lizzazione sullo scher- 
mo: il risultato è il bel- 
lissimo macchione 
grigio che si può am- 
mirare nella Figura 2. 
Non è finita: la casella 
dei risultati non viene 
svuotata prima del 
calcolo, anche se il 
programma lo chiede 
esplicitamente (_out- 
put .setTextC'"))- Evi- 
dentemente il sistema 
grafico di Java non fa 
in tempo ad aggiorna- 
re lo schermo prima che il lungo calcolo dei risulta- 
ti lo blocchi. E se avessi voluto dare all'utente una 
barra di avanzamento, o qualche altro strumento 
per indicare il tempo restante per finire il calcolo? 
Sarebbe stato tutto inutile: senza il "refresh" del 
video, la mia barra sarebbe apparsa solo al termine 
dell'operazione. Brutto. Inaccettabile. Qui bisogna 
correre ai ripari. 

Il box "La coda degli eventi" spiega perché l'interfac- 
cia si blocca, e suggerisce una soluzione. Chi non sa 
cosa sia la coda degli eventi di Java, dovrebbe legge- 
re questo box, prima di continuare. 



USIAMO I THREAD 

Per evitare che l'interfaccia si fermi durante le ope- 
razioni lente, devo fare in modo che il calcolo avven- 
ga in un thread separato. In questo modo il control- 
lo tornerà alla coda degli eventi di Java appena pos- 
sibile. Così la coda degli eventi potrà occupare il pro- 
prio tempo in cose utili come aggiornare lo scher- 



*n u ... nnx 






Da: 

A. 


10.000.0 


■i e nnn n 



Fig. 2: I-interfaccia non 
viene aggiornata durante 
l'elaborazione dei dati 
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mo, anziché restare in attesa sulla soglia per quaran- 
ta interminabili secondi. 

public class NumeriPrimi extends JPanel... 
public NumeriPrimi(Server s) { 
_server = s; 
inizialìzzaGUI(); 

_ok.addActionListener(new ActionListenerQ { 
public void actionPerformed(ActionEvent ev) { 
lanciaCalcoloInNuovoThread() ;}});} 
private void lanciaCalcoloInNuovoThread() { 
Runnable calcolo = new RunnableQ { 
public void run() { 

calcolaNumeriPrimi();}}; 
Thread t = new Thread(calcolo); 
t.start(); } 



Anziché chiamare direttamente il metodo calcola- 
NumeriPrimiO, l'azione legata al pulsante chiama 
lanciaCalcoloInNuovoThreadO- Questo metodo de- 
finisce (con una classe anonima) un nuovo Runna- 
ble, il cui metodo run() chiama a sua volta calcola- 
NumeriPrimiO- Il Runnable viene usato per costrui- 
re un Tliread, che parte subito. Il metodo run() girerà 
in un thread parallelo, senza costringere la coda de- 
gli eventi ad aspettare la fine del calcolo. L'ho prova- 
to, e funziona: l'interfaccia non si congela più. Sem- 
bra che quest'ultima versione del programma vada 
bene. Ma quando si tratta dei thread, le cose sem- 
brano spesso più semplici di quello che sono. 



richiedono molta attenzione. Vale la pena di dare 
un'ultima occhiata al programma, per essere 
sicuri di non aver dimenticato qualche risorsa 
condivisa che potrebbe causare problemi. 
In questa circostanza devo essere certo che nes- 
sun campo di NumeriPrimi possa essere 
letto/modificato in parallelo da più thread. Ad 
esempio, due thread potrebbero cercare di stam- 
pare contemporaneamente sulla JTextArea. Ora 
che lanciaCalcoloInNuovoThreadO è sincroniz- 
zato, non mi vengono in mente situazioni nelle 
quali potrebbe succedere una cosa simile. Direi 
che posso essere abbastanza sicuro. Quanto alla 
classe Server, non può causare problemi di sin- 
cronizzazione, perché non ha campi; quindi non 
ha uno stato che possa essere condiviso da più 
thread. Anche se molti client usassero questa 
classe in parallelo, non ci sarebbero problemi. 
Ma se avessi molti client cercherei probabilmen- 
te di rendere il sistema un po' più veloce, e que- 
sto potrebbe significare aggiungere dei campi al 
Server. 

Ad esempio potrei conservare una cache dei 
numeri primi già calcolati per determinati inter- 
valli. Se lo facessi, l'accesso a questa cache 
dovrebbe essere sincronizzato. In caso contrario, 
un client potrebbe cercare di modificarne i valo- 
ri mentre un altro client cerca di leggerli da un 
thread diverso. 

Paolo Perrotta 




LA CODA DEGLI EVENTI 



SINCRONIZZIAMO 

Ho fatto qualche prova per verificare se è possibile 
premere il pulsante più di una volta, lanciando più 
calcoli in parallelo. Con l'aiuto di qualche stampa 
sullo schermo, ho scoperto che un utente dal dito 
lesto riesce facilmente a premere il tasto due volte di 
seguito. Il problema è che lanciare un thread è un'o- 
perazione lenta; quindi passa un po' di tempo tra il 
momento in cui il controllo torna alla coda degli 
eventi e il momento in cui il pulsante viene disabili- 
tato in calcolaNumeriPrimiQ. Durante questo breve 
intervallo, è possibile premere una seconda volta il 
pulsante. Per risolvere il problema ho sincronizzato 
il metodo lanciaCalcoloInNuovoThreadO- Ora il me- 
todo non può essere eseguito in parallelo da più 
thread sulla stessa istanza del programma. Un'alter- 
nativa è quella di disabilitare il pulsante appena pos- 
sibile, cioè nel thread degli eventi anziché in quello 
dei calcoli. Ecco una versione del programma che fa 
entrambe le cose: 

private synchronized void lanciaCalcoloInNuovoThreadO { 
_ok.setEnabled(false); 

Le sincronizzazioni sono bestiole pericolose, che 



Per quale motivo l'interfaccia 
grafica si "congela" quando parte 
un'operazione molto lenta? In un 
programma Java sono attivi, in ogni 
momento, diversi thread. Uno 
molto famoso è il thread principale, 
cioè il thread all'interno del quale 
viene chiamato il metodo maini). 
Nel caso di un programma grafico 
come NumeriPrimi, però, il maini) 
termina quasi subito. Eppure il 
programma non termina, perché re- 
stano in vita altri thread 
importanti. Uno di questi è la coda 
degli eventi. La cosa degli eventi si 
occupa di gestire tutti gli eventi del 
sistema grafico. Se l'utente preme 
un pulsante, questo evento finisce 
nella coda degli eventi. DI 
conseguenza la coda degli eventi 
chiama il metodo Ac- 
tionListener.actionPerformedi) di 
tutti i "listener" collegati al pulsan- 
te. Se non ci fosse la coda degli 
eventi, il sistema non si accorge- 
rebbe che l'utente ha premuto il 
tasto - a meno che il programma 
non fosse fermo e concentrato sulla 



lettura di quel particolare tasto. Il 
metodo actionPerformedi) non vie- 
ne chiamato dal thread principale, 
ma dal thread degli eventi. Il thread 
degli eventi si ferma fino a quando 
il actionPerformedi) non è ter- 
minato - nel nostro caso, fino a 
quando il metodo calcolaNumeri- 
PrimiO non ha finito di fare conti. 
Nel frattempo, tutti gli eventi nel 
sistema sono sospesi. È inutile clic- 
care su un altro pulsante: nessuno 
sarà lì a ricevere questo evento. E 
purtroppo anche gli aggiornamenti 
dello schermo sono eventi, quindi 
anch'essi resteranno bloccati in at- 
tesa. Questo è il motivo per cui, in 
risposta ad un evento della GUI, do- 
vremmo sempre cercare di restituire 
il controllo il prima possibile. 
Questo purtroppo non è sempre 
facile. In questo articolo risolviamo 
il problema con un nuovo thread, 
parallelo sia al thread principale (se 
è ancora in vita) che alla coda degli 
eventi. Questo thread si occupa del 
calcolo parallelo, e il controllo torna 
subito al sistema grafico. 
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Mono, un ponte 
fra Windows e Linux 

Per quanto possa sembrare strano, è possibile programmare 
utilizzando .NET e C# anche in ambiente Linux. È Mono a consentire 
tutto questo, vediamo come funziona e quali vantaggi porta 




□ CD □ WEB 

MonoCodice.zip 



■••■•■■• • 




REQUISITI 



u.u.umm 



f— 1 Basi di C# 



, Mono 1.0.5, Windows 
jj 2000 o superiore 
o Linux 



Tempo di realizzazione 



Mono è un'implementazione open 
source della piattaforma .NET. Essa 
include gli strumenti, le librerie, e il 
compilatore richiesti per costruire software su 
varie piattaforme quali: Linux, Windows e 
MacOS. Abbraccia, inoltre, diverse architetture, 
dalla x86 ai computer s390. In quest'articolo 
vedremo come installare Mono, sia su Linux sia 
su Windows, ed esamineremo alcuni degli stru- 
menti che esso ci fornisce. Infine utilizzeremo 
C# per scrivere due esempi di tipo Console e 
uno GUI. Quest'ultimo con l'ausilio di Gtk#, 
che è la libreria preferita per la costruzione di 
applicazioni GUI, usando Mono. 



PERCHE MONO? 

Gli sviluppatori Linux saranno sicuramente in- 
teressati a Mono, ma un programmatore Win- 
dows potrebbe chiedersi: "Perché dovrei inte- 
ressarmi a Mono se per Windows c'è già .NET 
Framework?" La risposta è semplice. 
A differenza di .NET di Microsoft, Mono è mul- 
tipiattaforma. Questo fa sì che un programma 
compilato con Mono "giri" indifferentemente 
su qualsiasi piattaforma su cui Mono è installa- 
bile. Eseguire un'applicazione sviluppata sotto 
Linux, su un altro sistema operativo che sup- 
porta Mono, sarà tanto semplice quanto copia- 
re gli assembly relativi ad essa sul sistema tar- 
get. Capiamo, quindi, che nessuno sviluppato- 
re, .NET e non, dovrebbe fare a meno di inte- 
ressarsi almeno minimamente a Mono. 



INSTALLAZIONE 
SU LINUX 

Sicuramente il modo più semplice per installa- 
re Mono su Linux è usare i package ufficiali. Gli 
utenti di sistemi RPM-based (Red Hat, SuSE, 



Fedora Core) possono scaricare gli RPM adatti 
alla loro distribuzione di Linux. L'URL di riferi- 
mento è http://www.mono-project.com/down- 
loadsl. 

Inoltre altre distribuzioni di Linux offrono sup- 
porto per Mono tramite canali dedicati. 
Per installare Mono attraverso i package: 

1 Puntare il browser all'URL sopra citato 

2 Cliccare su Packages accanto alla propria 
distribuzione 

3 Cliccare sul package che inizia per mono- 
core-1.0.5 nella sezione in alto a sinistra dal 
titolo Mono Core Runtime and C# compiler 

4 Aprire il file e procedere all'installazione 

A questo punto il package Mono core dovrebbe 
essere installato. In ogni caso, anche se non 
sono disponibili i package per la propria distri- 
buzione, è sempre possibile installare Mono dai 
sorgenti. 



INSTALLAZIONE 
SU WINDOWS 

L'installazione su Windows sarà molto sempli- 
ce. Puntiamo il browser alla pagina 
http://www.go-mono.com e andiamo all'area 
download. Scarichiamo l'installer e lanciamolo 
facendo il classico doppio click su esso. Questo 
installerà Mono in C:\Programmi\Mono-L0.5 o 
nella directory da noi specificata in fase di 
installazione. 

Sotto la cartella bin troviamo i file batch che 
"wrappano" gli eseguibili che useremo per 
compilare ed eseguire i programmi e fare altre 
operazioni. A questo punto conviene aggiunge- 
re il percorso C:\Programmi\Mono- 1.0. 5\bin\ 
alla path. 

Questo ci permetterà di usare i comandi di 
Mono da qualsiasi directory ci troviamo. 
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SCRIVIAMO 

UHI PO' DI CODICE 

Facciamo un indovinello. Quale sarà il primo 
programma che scriveremo? Indovinato! Proprio 
"Hello World". Aprite il vostro editor di testi pre- 
ferito e digitate il seguente codice: 

using System; 
public class HelloWorld { 
static void Main() { 



System. Console. WriteLine("Hello World");} 



} 



Salviamo il file col nome Hello.cs. A questo pun- 
to, per compilarlo, basta eseguire il comando 
mcs Hello.cs. Se tutto è andato a buon fine, do- 
vrebbe comparire il messaggio "Compilation 
Succeeded" ed il risultato sarà il file Hello.exe che 
si troverà nella stessa directory dalla quale ab- 
biamo lanciato il comando. Se invece vi dà qual- 
che errore, assicuratevi di aver aggiunto alla 
PATH i percorsi indicati nel paragrafo "Installa- 
zione su Windows" o, se proprio non volete farlo, 
di essere sotto la directory bin di mono. A questo 
punto non ci resta che lanciare la nostra prima 
"applicazione" compilata con Mono. Per farlo, 
eseguite il seguente comando: mono Hello.exe. 
Il risultato è la stringa Hello World visualizzata 
sulla Console. Quello che vogliamo mettere in 
evidenza, arrivati a questo punto, è una caratte- 
ristica molto interessante. Se siete su piattafor- 
ma Windows e avete .NET Framework installato, 
scrivete Hello.exe e premete invio. L'output sarà 
analogo a quello precedente e cioè Hello World. 
Sarebbe lecito chiedersi a questo punto: "Ok e 
qual è la caratteristica interessante di ciò, dato 
che abbiamo ottenuto lo stesso Hello World dell'i- 
struzione precedente?". La caratteristica molto in- 
teressante sta nel fatto che il Common Interme- 
diate Language (CIL), che abbiamo ottenuto 
compilando il programma con Mono, è stato 
eseguito senza batter ciglio dal CLR del .NET 
Framework di Microsoft! Ma com'è possibile ciò? 
La spiegazione sta nel fatto che il CLR è l'imple- 
mentazione di Microsoft delle specifiche del 
Common Language Infrastructure (Chi). 
Quest'ultimo è uno standard internazionale per 
creare ambienti di sviluppo ed esecuzione in cui 
i linguaggi e le librerie lavorano assieme senza 
problemi. Il fatto che sia uno standard ha reso 
possibile l'implementazione dello stesso da par- 
te di Mono. Questo fa sì che un programma scrit- 
to e compilato con Mono possa essere eseguito 
dal CLR di Microsoft. È vero anche il contrario, 
cioè se compiliamo l'esempio precedente col 
compilatore di Microsoft, questo potrà essere 
eseguito facendo uso di Mono. Credo che ora stia 
iniziando a venire fuori l'importanza di quest'ul- 



timo. Sfortunatamente, "per ora", non è tutto così 
bello come sembra. Il problema è che non tutto 
il codice compilato con Mono può essere esegui- 
to usando il CLR di Microsoft e non tutto il codi- 
ce compilato col compilatore della casa di Red- 
mond può essere eseguito usando Mono. La 
spiegazione a ciò sta nella definizione di applica- 
zione 100% .NET 



APPLICAZIONI 100% .NET 

Un'applicazione è 100% .NET se fa uso esclusiva- 
mente di API definite sotto il namespace System 
e non fa chiamate di tipo Pllnvoke (Platform 
Invoke). Una chiamata di tipo Pllnvoke può esse- 
re, ad esempio, una chiamata ad un'API di Win- 
dows (e quindi unmanaged code) da codice ma- 
naged scritto in C#. Ad esempio, per chiamare 
TAPI MessageBeep di Windows potremmo usare 
il seguente codice all'interno del nostro pro- 
gramma C#: 



[DIIImport("User32.dll")] 

static extern Boolean MessageBeep(UInt32 beepType); 

MessageBeep(O); 

In questo caso, il problema risiede nel fatto che 
abbiamo legato la nostra applicazione ad una 
piattaforma specifica (Windows) e ciò fa cadere 
il motivo per il quale Mono è nato e cioè l'esse- 
re multipiattaforma. A parte questo, c'è un altro 
problema. Mono non è "ancora" un'implemen- 
tazione completa di .NET Diciamo "ancora" 
perché l'obiettivo primario del progetto è di 
implementare tutte le API del framework .NET 
Ad esempio, una buona parte delle classi pre- 
senti in System.Windows.Forms, non è ancora 
stata implementata. In Figura 1 è visibile lo 
stato in cui si trova l'implementazione di 
System.Windows .Forms. Come si può vedere 
una buona parte del namespace non è ancora 
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Sito del progetto: 

http://www.mono-project 
.com/about/index.html 

Stato delle librerie di 
classi di Mono: 

http://www.qo-mono 
.com/class-status.html 

Pagina relativa al pro- 
getto Gtk#: 

http://gtk-sharp.sour- 
ceforqe.net/ 

Specifiche per C#: 

http://www.ecma.ch 
/ecmal /STAND 
/ecma-334.htm 

Specifiche per il CLI: 

http://www.ecma.ch 
/ecmal /STAND 
Zecma-335.htm 




BIBLIOGRAFIA 



• MONO: A DEVELOPER'S 

NOTEBOOK 

Niel NI. Bornstein 

Edd Dumbill 

(O'Reilly) 



Fig. 1: Stato in cui si trova l'implementazione di 
System. Windows. Forms 
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MODIFICA 

DELLA PATH 

SU WINDOWS 

Per impostare la PATH 
su Windows 2000 o XP 
bisogna eseguire i se- 
guenti passi: seleziona- 
re Impostazioni dal me- 
nu start ed aprire il 
Pannello di Controllo; 
quindi selezionare Si- 
stema. Selezionare il 
tab Avanzate. Selezio- 
nare Variabili d'ambien- 
te e cercare Path tra le 
Variabili di Sistema. 
Aggiungere il percorso 
;C:\Programmì \Mono- 
1.0.5\bin\ all'estremità 
destra della variabile 
Path. Premere Off. 

•^m 

Regole per realizzare 

applicazioni .NET mul- 

tipiattaforma 



• Preferire l'uso di 

Gtk# a System.Win- 

dows.Forms 

• Evitare il più possibi- 
le l'uso di Pllnvoke su 

librerie native. 

• Non leggere le chiavi 
di registro, attraverso 

Microsoft. Win32. Regist 
ry, che sono supporta- 
te da Windows. 
• Non usare percosi 
assoluti. 



Ad esempio: 



// SBAGLIATO 



string percorso = 

directory + "/" + 
filename; 



// GIUSTO 



string percorso = 

System. IO. Path. Combine 
(directory, filename); 



implementata. Ovviamente le librerie di classi 
già implementate in Mono, non sono tali da 
permetterci di scrivere solo il famigerato Hello 
World. A riprova di ciò scriviamo un program- 
mino che estragga da un URL tutti i link presen- 
ti all'interno dello stesso e li scriva in un file di 
testo. 

Per fare ciò useremo i seguenti namespace: 
System, System.IO, System. Text.RegularExpres- 
sions e System.Net. 
Il listato è il seguente: 

using System; 

using System.IO; 

using System. Text.RegularExpressions; 

using System.Net; 



public class LinksSniffer 



{ static void Main(string[] args) 



{ if(args.Length != 1) { 



Console. WriteLine("Sintassi: LinksSniffer URL"); 



return;} 



StreamReader reader = nuli; 



StreamWriter writer = nuli 



try { 



writer = new StreamWriter("links.txt", false); 



WebRequest request 



WebRequest.Create(args[0]); 



WebResponse response = request. GetResponse(); 
reader = new StreamReader( 

response. GetResponseStream()); 
Regex regex = new Regex("<a.*?href\\s*=\\s*\ 
"([ A \"]*)\"", RegexOptions.IgnoreCase); 



string line 



while((line = reader.ReadLine()) != nuli) { 

MatchCollection matches = regex. Matches(line); 
foreach(Match singleMatch in matches) 
writer. WriteLine(singleMatch.Groups[l]);}} 
catch (Exception e) { 

Console. WriteLine(e.Message);} 
finally { 

if(writer != nuli) 
writer.ClosefJ; 
if( reader != nuli) 
reader.CloseQ;}}} 



Salviamo il programma col nome LinksSnijfer.es 
e compiliamolo con: mes LinksSnijfer.es. 
Questa classe non fa altro che prendere l'URL 
che passiamo da riga di comando ed effettuare il 
parsing del codice html tramite l'uso di un'e- 
spressione regolare. Ogni occorrenza che rispet- 
ta il pattern della Regex, è scritta in un file di testo 
di nome links.txt. Un esempio d'uso è: mono 
LinksSniffer.exe http://www.mono-project.com la- 
boutlindex.html. Chiaramente l'utilità di tale 
classe è ampiamente opinabile. 
L'unico scopo in questo contesto era dimostrare 
che Mono ha già implementato abbastanza clas- 



si delle librerie .NET. Il progetto è comunque in 
continua espansione e lo scopo principale è 
quello di implementare .NET al 100% . A parte 
questo, sono stati e saranno implementati, altri 
toolkit che faciliteranno la vita di noi sviluppa- 
tori. Tra questi emerge Gtk# il quale permetterà 
lo sviluppo di interfacce grafiche utente (GL77) 
con l'importante caratteristica di essere multi- 
piattaforma. 



APPLICAZIONI GUI 
COM GTK# 



Hello World L □ X 



Cliccami 



Fig. 2: Hello World GUI con 
Gtk# su Windows 



Prima di concludere 
la nostra panorami- 
ca su Mono non 
potevamo fare a 
meno di costruire 
un semplicissimo 
esempio di applica- 
zione GUI usando 
Gtk#. Gtk# è il "wrapper" Mono per Gtk+. 
Quest'ultimo è ampiamente utilizzato per svi- 
luppare interfacce grafiche, soprattutto in am- 
biente Linux. 

A tal proposito, arrivati a questo punto, gli utenti 
Linux dovranno scaricare ed installare il package 
relativo a Gtk# dalla pagina http://www.mono- 
project.com/downloads/ seguendo una procedu- 
ra analoga a quella dell'installazione del package 
mono-core-1.0.5 vista nel paragrafo Installazione 
su Linux di quest'articolo. Gli utenti Windows 
invece non dovranno preoccuparsi di ciò poiché 
Gtk# è già incluso nell'installer. Senza scendere 
troppo nei dettagli, costruiamo il nostro primo 
semplice programma usando Gtk#. 
Esso sarà composto solamente da una finestra e 
un bottone. Ogni volta che sarà cliccato il botto- 
ne apparirà la stringa ioProgrammo sulla 
Console. Il risultato finale sarà quello visibile in 
Figura 2. 
Il listato relativo ad esso è il seguente: 

using Gtk; 
using GtkSharp; 
using System; 
public class Hello { 
static void Main() { 
Application. Init (); 

Window window = new Window ("Hello World"); 
Button btn = new Button ("Cliccami"); 
btn.Clicked += new EventHandler (HelloEvent); 
new DeleteEventHandler 
(WindowDeleteEvent); 



window. DeleteEvent + = 



window. Add (btn); 



window. ShowAII (); 



Application. Run ();} 
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static void WindowDeleteEvent (object obj, 

DeleteEventArgs args) { 
Application. Quit ();} 
static void HelloEvent (object obj, EventArgs args) { 
Console. WriteLine("ioProgrammo");}} 

Per compilare questo programma usare il se- 
guente comando: 



sotto Windows: 

mcs hellogtk.cs -lib:"C:\Programmi\Mono-1.0.5 

\lib\mono\gtk-sharp" -rigtk-sharp.dll 

sotto Linux: 

mcs hellogtk.cs -r:gtk-sharp -lib:/usr/lib/mono 

/gtk-sharp 

Ovviamente se avete installato Mono su una di- 
rectory diversa, dovrete adattare il percorso in 
-lib di conseguenza. Nel nostro caso, hellogtk.cs 
è il nome che abbiamo dato al file e gtk-sharp.dll 
è la libreria relativa a Gtk#. L'opzione -r indica 
che stiamo referenziando quella libreria, mentre 
-lib indica dove si trova. Per eseguirlo basta edi- 
tare: mono hellogtk .exe. È possibile notare che, 
come ogni toolkit per la costruzione di interfac- 
ce grafiche, anche Gtk# è guidato dagli eventi. 
Questo significa che la GUI "dormirà" in Applica- 
tion. Run() finché non si verificherà un evento. In 
tal caso il controllo è passato al metodo associa- 
to a quell'evento particolare. Infine c'è una cosa 
da notare. L'assegnazione dei gestori degli even- 



ti l'abbiamo fatta utilizzando la notazione estesa 
per enfatizzare l'uso dei delegati. Nella pratica 
potrebbe preferirsi la notazione breve. 
Quindi possiamo scrivere: 

window.DeleteEvent += WindowDeleteEvent; 
btn.Clicked += HelloEvent; 

al posto di: 

window.DeleteEvent += new DeleteEventHandler 

(WindowDeleteEvent); 
btn.Clicked += new EventHandler (HelloEvent); 

raggiungendo lo stesso identico risultato. 



CONCLUSIONI 

In quest'articolo abbiamo visto alcune delle ca- 
ratteristiche di Mono. Il progetto è ancora 
molto giovane (la prima release è avvenuta a 
fine giugno '04) ma non per questo da sottova- 
lutare. Basti pensare al fatto che Mono suppor- 
ta anche ASP .NET, ADO.NET e MonoBASIC 
(Visual Basic .NET) anche se ancora non com- 
pletamente. Diamogli il tempo di lavorare e 
potremo finalmente scrivere anche la nostra 
Web Application in ASP .NET e vederla "girare" 
indifferentemente, sia su server Windows sia su 
server Linux. 

Alessandro Locava 




INSTALLAZIONE 
SU LINUX 
DAI SORGENTI 

Per eseguire l'installa- 
zione dai sorgenti: 

1 Scaricare i sorgenti 
andando all'URL 

http://www.mono-proìect 
.com/downloads/. 



2 Loggarsi come utente 
root 

3 Decomprimere il file 
scaricato usando il co- 
mando tar -xvzf mono- 
LO.S.tar.gz 

4 Andare sotto la direc- 
tory mono- 1. 0.5 

5 Eseguire il comando 
.Iconfigure 

6 Per compilare i sor- 
genti eseguire il co- 
mando make 

7 Per eseguire l'instal- 
lazione vera e propria 
eseguire make instali 





HELLO WORLD GUI CORI GTK# 

IMPORTIAMO I NAMESPACE CREIAMO GLI OGGETTI DELLA NOSTRA GUI 




GESTIAMO GLI EVENTI 






using Gtk; 




Application. Init (); 

Window window = new Window ("Hello 

World"); 

Button btn = new Button ("Cliccami"); 




btn.Clicked += new EventHandler 

(HelloEvent); 
window.DeleteEvent += new 
DeleteEventHandler (WindowDeleteEvent); 




using GtkSharp; 
using System; 




WM Questi sono i namespace che 
LI contengono le classi che ci inte- 
ressano per la costruzione della nostra 
GUI tra le quali Window e Button. 
Sono sufficienti per iniziare. 

VISUALIZZIAMO LA FINESTRA 




n Init fa sì che la libreria Gtk# sia ini- 
KM zializzata. Di seguito viene creata la 
Finestra principale che avrà come titolo 
Hello World e il bottone che avrà come 
testo la stringa Cliccami 

GESTIAMO LA PRESSIONE DEL BOTTONE 




EV Queste due righe di codice non 
Ci fanno altro che, associare all'even- 
to relativo alla pressione del bottone e a 
quello relativo alla chiusura dell'applica- 
zione, i corrispondenti metodi. 

GESTIAMO LA CHIUSURA DELLA FINESTRA 






window. Add (btn); 




static void HelloEvent (object obj, 

EventArgs args) 

{ 

Console. WriteLine("ioProgrammo"); 




static void WindowDeleteEvent (object obj, 
DeleteEventArgs args) 

{ 
Application. Quit (); 

} 




window. ShowAII (); 


Application. Run (); 


} 




OTI Prima di visualizzare la finestra vie- 
U ne aggiunto ad essa il bottone crea- 
to in precedenza. Run fa sì che la GUI ven- 
ga mostrata e, cosa più importante, la 
mantiene aperta, aspettando che si verifi- 
chino eventi, finché viene chiamato Quit. 




n Come abbiamo visto al passo 3, 
U questo è il metodo che è stato 
associato all'evento relativo alla pressio- 
ne del bottone. Tale metodo non fa altro 
che visualizzare a Console la stringa 
oProgrammo. 




wm Analogamente al passo 5 questo 
\iM metodo viene chiamato quando di 
verifica un evento. In questo caso tale 
metodo è associato all'evento relativo 
alla chiusura della finestra. Il suo scopo è 
semplicemente quello di chiudere la GUI. 
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.NET Remoting: software 
che comunicano 

Vedremo come creare host e invocare oggetti remoti da codice senza 
l'uso di file di configurazione. Impareremo come accedere al server 
usando un'interfaccia ed effettuare una chiamata bidirezionale 




□ CD □ WEB 

Remoting.zip 



^ 



^* ■ •' m 



n 




REQUISITI 



Ì4J.WU.UM 
/il .NET livello elevato 



'x Microsoft Windows 
J'J 2000 o XP e Microsoft 
Visual Studio .NET 2003 



I J I i 



Tempo dì realizzazione 



c 



hi segue costantemente ioProgrammo, ri- 
corderà che nel numero precedente abbia- 
mo illustrato le basi di .NET remoting, ovve- 
ro la tecnologia che consente a due programmi resi- 
denti su macchine diverse di comunicare fra loro. Il 
fine di questa tecnologia è quello di consentire la 
creazione di applicazioni distribuite, tali che piccoli 
spezzoni di codice, specializzati nella risoluzione di 
un solo singolo problema possano essere dislocati 
ovunque all'interno di una rete aziendale o nel 
mondo. Le varie parti del software comunicando fra 
loro contribuiranno a formare un'unica grande 
applicazione che usufruisce di un'elevata capacità 
computazionale derivata dall'usare molte macchi- 
ne, le quali hanno un carico ridotto di compiti. Ci 
sono altri vantaggi evidenti nell'uso di questa tecni- 
ca, ne abbiamo diffusamente parlato nello scorso 
numero. Nell'illustrare questa tecnologia avevamo 
mostrato come le direttive relative a porta su cui un 
servizio si mette in ascolto, protocollo di trasporto e 
le altre direttive relative alla configurazione client 
/server potessero risiedere su un file .config, separa- 
to dal codice dell'applicazione. In questo articolo 
illustreremo la tecnica inversa, ovvero configurere- 
mo l'applicazione client e l'applicazione host inse- 
rendo le direttive direttamente nel codice. 



USARE REMOTING 

SENZA FILE 

DI CONFIGURAZIONE 

L'uso del file di configurazione per impostare le in- 
formazioni di remoting è estremamente comodo 
perché consente, con una sola istruzione, di fruire in 
modo trasparente di questa tecnologia senza mini- 
mamente modificare il proprio codice. È però vero 
che tale modello può risultare in taluni casi un po' 
rigido. Può rendere complicata l'implementazione 
di politiche di configurazione più sofisticate o legate 
alla logica applicativa, al punto che una possibilità 
nata come semplificazione all'uso della tecnologia 
può trasformarsi in una limitazione. Ed ecco la solu- 



zione: configurare remoting da codice e senza l'uso 
di file .config. Partiamo innanzitutto dal client. Pri- 
ma di continuare, è utile definire il client come l'ap- 
plicazione che usufruisce di un servizio remoto, e 
l'host come l'applicazione che espone il servizio. Di- 
remo formatter il modello secondo cui i dati vengo- 
no scambiati, diremo channel il protocollo di comu- 
nicazione utilizzato. 

Supponiamo di voler ricalcare via codice il seguente 
file di configurazione esterno: 

< system, runtime. remoting > 
opplication name="myClient"> 
<channels> 

<clientProviders> 
<channel ref="tcp" port="0"> 



<formatter ref="binary" /> 



</clientProviders> 



</channel> 



</channels> 



<client> 



<wellknown type="ioProgrammo 

.RemotingServices. Server, Server" 
uri = "tcp://localhost: 8737 /remotingData 

/myFirstService" /> 
</client> 



</application> 



</system. runtime. remoting > 

Gli elementi che questo file configura sono fonda- 
mentalmente tre: il formatter usato, il channel usato 
e il tipo da richiamare via remoting. Tenteremo di ri- 
calcare la stessa configurazione, all'interno del co- 
dice di un'ipotetica applicazione. Innanzitutto dob- 
biamo aggiungere nel progetto client un riferimento 
ad un assembly di sistema registrato nella GAC ed in 
particolare System.Runtime.Remoting.Dll. A questo 
punto possiamo procedere con la dichiarazione del- 
le using corrispondenti: 

using System. Runtime. Remoting; 

using System. Runtime. Remoting. Channels; 

using System. Runtime. Remoting. Channels. Tcp; 
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Cominciamo con la definizione del formatter che, 
nel nostro caso, è il classico BinaryFormatter: 

BinaryClientFormatterSinkProvider formatterProvider 
= new BinaryClientFormatterSinkProvider(); 

Tale oggetto può essere associato soltanto al chan- 
nel, come si evince anche dalla struttura xml del file 
di configurazione, e dunque passiamo a definire 
quest'ultimo: 



if 


( ChannelServices.GetChannel("tcp") == nuli 


){ 




IDictionary props 


= new Hashtable(); 






props["name"] = 


'tcp"; 




props["port"] = 0; 




TcpChannel channel = new TcpChannel( 

props, formatterProvider 


nuli); 


ChannelServices.RegisterChannel(channel); 


} 



Abbiamo quindi semplicemente istanziato un chan- 
nel di tipo TcpChannel passando al costruttore le 
proprietà name e port. Quest'ultima potrebbe sem- 
brare inutile nel client, ma è necessaria quando si 
vuole instaurare una comunicazione bidirezionale, 
come osserveremo nel proseguo. Al costruttore del 
channel passiamo anche il formatter legandoli così 
in modo indissolubile. A questo punto semplice- 
mente registriamo il channel nel sottosistema di re- 
moting della nostra applicazione .NET Per precau- 
zione verifichiamo prima che il channel non sia 
stato già precedentemente registrato in modo da 
evitare errori a runtime. Infine possiamo effettuare 
la chiamata al nostro oggetto ioProgrammo.Remo- 
tingServices.Server. Quando facevamo uso nel no- 
stro file di configurazione, l'istanziazione era una 
banale: 

Server server = new Server(); 

Configurando tutto da codice potremmo ottenere 
lo stesso risultato, ma forse è più opportuno usare 
quest'altra forma decisamente più flessibile: 

Server srv = (Server) Activator.GetObject( 

typeof(Server), 
"tcp://localhost:8737/remotingData/myFirstService" ); 

A fare tutto il lavoro è l'oggetto SystemActivator, che 
espone il metodo statico GetObject. Ad esso è suffi- 
ciente passare il tipo dell'oggetto da richiamare, ot- 
tenuto da una semplice typeof, in modo da consen- 
tirne il corretto marshaling, e l'indirizzo del servizio 
remoto che espone tipo. Tale indirizzo è un nor- 
male URI e quindi è nella forma: 

<channel>://<ip_o_indirizzo_host>:<porta>/ 

<applicazione_remota>/<servizio_esposto> 



Nel nostro caso il channel è il tcp che abbiamo appe- 
na registrato, l'indirizzo è localhost su porta 8737, 
come già definito nell'esempio introdotto nello 
scorso articolo. E sempre in quell'esempio avevamo 
definito l'applicazione remota "remotingData" e il 
servizio "myFirstService" che pubblicavano la classe 
Server. È evidente che tutto ciò che serve alla sua 
istanziazione è solo la stringa dell'URI e questo ci 
consente di rendere straordinariamente dinamica 
l'invocazione via remoting perché ogni volta che 
vogliamo cambiare l'indirizzo dell'oggetto non dob- 
biamo modificare il file .config, ma solo fornire una 
differente stringa all'Activator. Tale stringa, ad esem- 
pio, potrebbe essere ottenuta da un database e 
potrebbe variare in relazione ai diritti dell'utente o 
in base ad altri fattori quali il carico di elaborazione 
del o dei server o l'operare in locale o in remoto via 
Internet. Potremmo avere un servizio fisso che funga 
da Directory e cioè che, a richiesta, esponga le Uri da 
utilizzare. Per cui un client invocherebbe sempre un 
metodo GetURI e questo risponderebbe con una 
URI dinamicamente determinata in base alla logica 
applicativa. Insomma un Object Broker estrema- 
mente semplice ma efficace. A questo punto siamo 
già in grado di invocare il servizio tenuto in piedi 
dall'host di esempio mostrato nello scorso articolo. 
Tale host era definito con solito file di configura- 
zione: 

<?xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<system. runtime. remoting > 



opplication name= "remotingData" > 
<channels> 

<channel ref="tcp" port="8737"> 
<serverProviders> 



<formatter ref="binary" 

typeFilterl_evel = "FuN" /> 



</serverProviders> 



</channel> 



</channels> 



<service> 



<wellknown mode="SingleCall" 



type="ioProgrammo.RemotingServices 
.Server, Server" 
objectUri = "myFirstService" /> 



</service> 



</application> 



</system. runtime. remoti ng> 



</configuration> 

Ma se volessimo configurare anche l'host da codice, 
analogamente a quanto fatto per il client, dovremo 
aggiungere il riferimento all'assembly System.Runti- 
me.Remoting.Dll e dichiarare con la using gli stessi 
namespace usati nel client. Inoltre dovremo anche 
riferire l'assembly contenente l'oggetto da esporre, 
operazione che nel caso dell'host con file di configu- 
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razione non si rende necessaria. A questo punto 
possiamo istanziare il BinaryFormatter lato server. 
Questa operazione è necessaria per impostare il 
parametro "typeFilterLevel" a "Full", necessario per 
ottenere la bidirezionalità. Dunque istanziamo il 
channel nella version server e impostiamo la porta 
8737 necessaria al funzionamento del nostro esem- 
pio: 

IDictionary props = new Hashtable(); 
props["typeFilterLevel"] = "Full"; 
BinaryServerFormatterSinkProvider formatterProvider 
= new BinaryServerFormatterSinkProvider(props, nuli); 



props = new Hashtable(); 



props["port"] = 8737; 



props["name"] = "tcp" 



TcpServerChannel channel = new 

TcpServerChannel(props, formatterProvider); 

Dunque non ci resta che dichiarare e pubblicare co- 
me WellKnownServiceTypeEntity il nostro oggetto 
ioProgrammo.RemotingServices.Server. Il costrut- 
tore di questo oggetto richiede il tipo dell'oggetto da 
pubblicare, il nome del servizio col quale sarà pub- 
blicato (il solito "myFirstService") e la modalità di 
esecuzione: 

WelIKnownServiceTypeEntry entity = 

new WellKnownServiceTypeEntry(typeof( 

ioProgrammo.RemotingServices. Server), 

"myFirstService", WelIKnownObjectMode 

.SingleCall); 

RemotingConfiguration.RegisterWelIKnownServiceType 

(entity); 



re il componente server in locale perché magari 
questo accede ad un database o ad una qualsiasi 
altra risorse sw/hw che è fisicamente inaccessibile al 
client e quindi perché conservare l'intero assembly 
del server sul client solo per qualche firma? La solu- 
zione è insita non nel modello di remoting ma nei 
principi dell' OOP stessa: il polimorfismo. 
Questo si può ottenere in due forme: per ereditarietà 
o per interfaccia. Nel caso del remoting è decisa- 
mente più auspicabile il secondo modello visto che 
ciò che serve al client è solo la struttura della classe, 
non una sua implementazione di base. Inoltre l'as- 
senza di ereditarietà multipla in NET e l'obbligo di 
derivare gli oggetti da remotizzare dalla classe 
MarshalByRefObject potrebbero introdurre delle 
limitazioni fastidiose se si optasse per il modello per 
ereditarietà. Dunque definiamo una semplice inter- 
faccia che contenga l'insieme delle proprietà e dei 
metodi che client invocherà sul server: 



public interface IRemoteServer { 


string ScalarMethod(string 


pari, 


ref 


nt 


pa 


r2); 


DataSet GetDataQ; 


} 



Tale interfaccia sarà definita in un assembly terzo di 
scambio che sarà comune al client e al server. Esso, 
infatti, non conterrà alcuna logica implementativa 
ma solo l'insieme delle classi e delle interfacce ne- 
cessaria alla corretta comunicazione tra client e ser- 
ver. A questo punto aggiungiamo nel progetto del 
server un riferimento all' assembly terzo e realizzia- 
mo una nuova classe server che implementa l'inter- 
faccia IRemoteServer: 



Infine dichiareremo nome dell'applicazione di re- 
moting: 

RemotingConfiguration.ApplicationName = "remotingData"; 

In pratica non abbiamo fatto altro che configurare 
tutte le parti della URI del servizio. 



UTILIZZO DI INTERFACCE 
DI PROGRAMMAZIONE 
NELLE CHIAMATE 
REMOTE 

La tecnica appena mostrata è davvero efficace in 
termini di flessibilità e di scalabilità del sistema, pe- 
rò impone ancora una rigidità evidente: il client e 
l'host devono condividere lo stesso assembly che 
contiene l'oggetto server. All'host serve perché evi- 
dentemente deve eseguirne il codice, ma al client 
serve semplicemente per conoscerne la struttura e 
cioè la firma dei metodi e delle proprietà. D'altro 
canto non è detto che il client sia in grado di far gira- 



public class InterfaceServer : MarshalByRefObject, 

IRemoteServer { 
#region IRemoteServer Members 
public string ScalarMethod(string pari, ref int par2) { 
//implementazione metodo ScalarMethod () } 
public DataSet GetData() { 

//implementazione metodo GetData() } 
#endregion 
} 



Dal punto di vista del server non è dunque cambia- 
to nulla e nemmeno dal punto di vista dell'host ci 
sono modifiche da apportare. Invece, è sul client che 
la differenza si fa sentire in modo evidente. Infatti 
client non sarà più tenuto a conservare un riferi- 
mento all' assembly del server, che quindi non verrà 
più distribuito a tutti i client, ma dovrà soltanto con- 
servare un riferimento all'assembly terzo che è asso- 
lutamente neutro, privo di implementazione, non 
direttamente eseguibile dal client nemmeno per 
errore e, soprattutto, privo di ogni riferimento ai 
dettagli implementativi del server o a risorse che 
esso usa. Ed infatti il client, per invocare il server, si 
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limiterà a scrivere: 

IRemoteServer srv = (IRemoteServer) 

Activator.GetObject(typeof(IRemoteServer), 
"tcp://localhost:8737/remotingData 

/myFirstService" ); 

Oltre all'indubbio vantaggio di non dover distribuire 
alcun componente server insieme ai client, questa 
tecnica polimorfica ci consente, in abbinamento ad 
un servizio di directory come quello esposto nei 
primi paragrafi, di far puntare il client a server com- 
pletamente diversi, su macchine diverse e, soprat- 
tutto, con classi implementative diverse che hanno 
semplicemente in comune il fatto di implementare 
l'interfaccia IRemoteServer. Gli scenari che si apro- 
no sono assolutamente vasti così come le possibilità 
di tuning e di configurazione delle proprie applica- 
zioni distribuite. 



COMUNICAZIONE 
BIDIREZIONALE 

Il modello tradizionale di programmazione distri- 
buita, implica che sia sempre un client a contattare 
in modalità sincrona il server e mai viceversa. Que- 
sto approccio è sostanzialmente sempre corretto, 
però in qualche caso può non risultare sufficiente. Si 
supponga, ad esempio, di voler sottoscrivere degli 
eventi del server (disconessioni, riawii per manu- 
tenzione, ecc..) e cioè tutte condizioni in cui deve 
essere il server a segnalare o a richiedere qualcosa ai 
client e non viceversa. In realtà anche queste situa- 
zioni possono essere gestite col tradizionale model- 
lo unidirezionale, magari con i client che effettuano 
un polling cadenzato al server per verificare che 
questi non abbia da comunicargli qualcosa. Certo 
non è elegante, ma se implementato bene può fun- 
zionare. Fortunatamente, però, l'architettura di re- 
moting offre la possibilità di una comunicazione ve- 
ra tra server e client. Per far questo è necessario che 
client sia disposto ad accettare richieste prove- 
nienti dal server. Come questo viene implementato 
dipende fortemente dal channel utilizzato. Ad esem- 
pio il channel http non consente questo modello di 
bidirezionalità. Invece, il channel Tcp fornito da Mi- 
crosoft lo consente, a patto però di aprire una nuova 
porta TCP sul client per ricevere le richieste dal ser- 
ver. Dunque due canali aperti su due porte differen- 
ti: sulla prima il client contatta il server e sulla secon- 
da il server contatta il client. Non è molto efficace ed 
è piuttosto pretenzioso in termini di richieste 
all'amministratore di rete, però funziona e in qual- 
che caso può risolvere un sacco di problemi di pro- 
grammazione. Vediamo, usando il channel TCP 
quali sono gli accorgimenti da adoperare per realiz- 
zare questa forma di bidirezionalità. Sull'host, come 



già accennato in precedenza, dobbiamo impostare il 

BinaryFormatter col parametro TypeFilterLevel a 

"Full": 

con file di configurazione: 



<serverProviders> 



<formatter ref="binary" typeFilterLevel = "Full" /> 
</serverProviders> 

oppure, se da codice: 

IDictionary props = new Hashtable(); 
props["typeFilterLevel"] = "Full"; 
BinaryServerFormatterSinkProvider formatterProvider = 
new BinaryServerFormatterSinkProvider(props, nuli); 

Invece sul client dobbiamo limitarci ad indicare la 
porta TCP sulla quale ricevere le comunicazioni dal 
server. Se non intendiamo fissarne una particolare, 
ma far scegliere al client al momento della richiesta, 
impostiamo semplicemente la porta a 0: 
con file di configurazione: 

<channel ref="tcp" port="0"> 

oppure, se da codice: 

IDictionary props = new Hashtable(); 

props["port"] = 0; 

TcpChannel channel = new TcpChannel(props, 

formatterProvider, nuli); 

Siamo così a pronti a ricevere comunicazioni dal 
server. Tali comunicazioni possono essere degli 
eventi del server che client ha sottoscritto o anche 
semplici richieste che server fa al client per ragioni 
applicative. Perché server possa contattare il client 
via remoting, anche sul client devono essere presen- 
ti oggetti con caratteristiche di remotizzabilità. Ed 
infatti nel nostro assembly comune tra client e ser- 
ver definiamo un oggetto client di remotizzazione 
che verrà usato dal server per effettuare le sue segna- 
lazioni al client: 

//Oggetto client definiti nell'assembly comune 
public class ClientObject : MarshalByRefObject { 
public delegate void MessageEvent (object sender, 

RemotingEventArgs e); 
public event MessageEvent SyncRemotingEvent; 
public event MessageEvent AsyncRemotingEvent; 
public virtual void OnAsyncServerNotification( 

RemotingEventArgs e) { 

try { 

if (AsyncRemotingEvent != nuli) 

AsyncRemotìng Event. BeginInvoke( 
this, e, nuli, nuli); } 
catch { } } 
public virtual void OnSyncServerl\lotification( 
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RemotingEventArgs e) { 
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try { 



if (SyncRemotingEvent != nuli) 

SyncRemotingEvent(this, e); } 



catch { } 



}} 



//oggetto eventargs che conterrà le informazioni sull'evento 
//scatenato anch'esso è definito nell'assembly comune 



[Serializable] 



public class RemotingEventArgs : EventArgs { 



private int _code; 



private string _message; 



public RemotingEventArgs(int code, string 

message) : base() { 



_code = code; 



_message = message;} 



public int EventCode { 



get {return _code; } 



} 



public string Message { 



get {return _message; } 



} } 



//nuova interfaccia IRemoteServer contentente i 
//metodi per passare il riferimento 
//all'oggetto ClientObject al server 



public interface IRemoteServer 



{ string ScalarMethod(string pari, ref int par2); 



DataSet GetData(); 



void TestAsyncBidirectionComm ( ClientObject 

client, string message ); 
void TestSyncBidirectionComm ( ClientObject client, 

string message ); 



} 



Ed ecco le implementazioni dei due metodi Test nel- 
la classe InterfaceServer: 

public void TestAsyncBidirectionComm(ClientObject 

client, string message) { 
client. OnAsyncServerNotification(new 

RemotingEventArgs(343, message)); 

_} 

public void TestSyncBidirectionComm(ClientObject 

client, string message) { 
client. OnSyncServerNotification(new 

RemotingEventArgs(341, message)); 
} 

Molto semplicemente, quando il client invoca il ser- 
ver passa anche un riferimento all'istanza di Client- 
Object; il server immediatamente invocherà il meto- 
do OnSyncServerNotification o OnAsyncServerNoti- 
fication del client aprendo, quindi, la comunicazio- 
ne nella direzione opposta. Il codice del client sarà 
altrettanto semplice: 

private void cmdTestBiSynk_Click(object sender, 

System. EventArgs e) { 



ClientObject client = new ClientObject(); 
ClientObject. MessageEvent handler = new 

ClientObject.MessageEvent( 
ServerRequestEventHandler); 
client. SyncRemotingEvent += handler; 
IRemoteServer srv = (IRemoteServer) Activator 

.GetObject(typeof(IRemoteServer), 
"tcp://localhost:8737/remotingData/myFirstService" ); 
srv.TestSyncBidirectionComm(client, "Sono il server!"); 
MessageBox.Show("Sono il clienti"); } 
public void ServerRequestEventHandler(object sender, 
RemotingEventArgs e) { 
MessageBox.Show(e. Message); 
} 



Il client crea un'istanza di ClientObject, l'evento 
SyncRemotingEvent con l'event handler ServerRe- 
questEventHandler, quindi istanzia il server e ne 
invoca il metodo TestSyncBidirectionComm pas- 
sando il riferimento all'oggetto ClientObeject ap- 
pena creato. Dopo qualche istante il server invo- 
cherà l'evento MessageEvent ripassando, quindi, la 
palla al client. La Figura 1 mostra con maggiore 
chiarezza questo meccanismo. 




Fig. 1: Il flusso della chiamata del metodo 
TestSyncBidirectionalComm 

Esiste, però, un potenziale problema: nell'event 
handler c'è una messagebox che quindi è bloccante 
perché viene atteso il click dell'utente. Questo signi- 
fica che il server resta in attesa della messagebox del 
client e, nell'ipotesi in cui il server sia una Singleton, 
ciò significherebbe che tutti i client resterebbero in 
attesa del click della messagebox su uno dei client! 
Questo è inacettabile, ma per fortuna in .NET esiste 
un ottimo supporto alle chiamate asincrone: in pra- 
tica possiamo fare in modo che il server invochi l'e- 
vento del client, ma non resti in attesa della risposta 
e che quindi lo invochi in forma asincrona. Per far 
ciò ci vengono in aiuto i delegate; ed ecco infatti che 
risulzione: 

if (SyncRemotingEvent != nuli) 

SyncRemotingEvent(this, e); 

diventa, con la Beginlnvoke del delegate che si na- 
sconde dietro l'evento: 
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if (AsyncRemotingEvent != nuli) 
AsyncRemotingEvent.BeginInvoke(this, e, nuli, nuli); 

L'effetto è facilmente osservabile eseguendo il pro- 
gramma. 



CONCLUSIONI 

Si conclude così questa lunga disamina della tecno- 
logia .NET Remoting. Nella Figura 2 possiamo ap- 
prezzare la nostra applicazione di prova in esecuzio- 
ne. Abbiamo avuto modo di conoscere in modo 
piuttosto approfondito la tecnologia e così adesso 
siete pronti ad utilizzarla in contesti reali e non solo 
in esempi gradevoli, ma poco utili nella realtà. Di 
questa tecnologia si potrebbe discutere ancora lun- 
gamente. Ad esempio si potrebbe mostrare come 
utilizzare channel di terze parti che migliorano le 
performance e le caratteristiche dei componenti ori- 
ginali Microsoft o, addirittura, come scrivere un pro- 
prio channel o altre parti dell'architettura di remo- 
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Fig. 2: II risultato: il nostro client in esecuzione 

tizzazione. Ma forse saranno argomento di prossimi 
articoli, intanto non vi resta che cominciare a pen- 
sare le vostre applicazioni in modo distributo: ades- 
so avete un formidabile strumento in più per realiz- 
zarle. 

Vito Vessici 




MODALITÀ SINGLE CALL E SINGLETON 



Un oggetto server di remoting può 
essere attivato in due modi: 

• SINGLE CALL (ogni richiesta dei client 
provoca una nuova istanziazione di un 
oggetto sul server che risponde 
all'invocazione del client e muore 
immediatamente dopo e questo accade 
per richieste consecutive dello stesso 
client); 

• SINGLETON (tutte le richieste di tutti i 
client vengono soddisfatte dalla stessa 
istanza dell'oggetto server remoto). 

La differenza è sostanziale e deve 
essere tenuta fortemente in conto 
quando si decide di implementare 
un'archiettura distribuita nelle proprie 
applicazioni usando .NET Remoting. Si 
osservi infatti questo esempio. Si sup- 
ponga di voler istanziare l'oggetto ser- 
ver: 

Server remoteObject = new ServerQ; 

Dopo questa istruzione l'oggetto server 



non è ancora stato contattato per cui 
nessuna istanza sul server viene creato 
né tanto meno viene controllato che il 
server sia in grado di rispondere. 
Soltanto all'invocazione del metodo la 
richiesta giunge effettivamente al 
server: 

DataSet ds = remoteObject. GetData(); 

Inoltre si supponga che l'oggetto Server 
disponga di una proprietà Name di tipo 
r/w e si osservi il codice in tabella. 
Il comportamento di tale codice, con 
l'oggetto Server che gira in remoting, è 
completamente diverso rispetto al suo 
omologo in locale e anche nella 
versione Single Cali e Singleton ci sono 
differenze consistenti. I vantaggi del 
Singleton sono evidenti in termini di 
semplificazione della programmazione. 
Esso infatti consente di mantenere gli 
stati interni da una chiamata all'altra 
(stateful) e inoltre fa da memoria cen- 
trale per tutte le richieste. Con un 
singleton, infatti, potrete conservare 



tutte le informazioni di tutti i clienti e 
avere sempre un'idea precisa di quanto 
sta accadendo nel vostro sistema 
software visto che ogni richiesta passa 
dal singleton e questo è in grado di 
tenerne traccia e di ricordarsene. Lo 
svantaggio è evidente: se il singleton va 
giù tutti i client vanno giù... Il Single 
Cali, d'altro canto, impone una 
programmazione senza stati (stateless) 
in cui tutto ciò che serve a rispondere 
ad una richiesta di un client deve essere 
passato come parametri del client stes- 
so o deve essere reperito dal server in 
altre forme (ad esempio da un 
database) e non si può programmare 
sperando che sia sempre la stessa 
istanza a rispondere a conservare le 
impostazione della chiamata 
precedente. Questo modello in 
compenso fornisce una scalabilità ed 
una robustezza ben maggiori. Dunque 
a voi la scelta. 

Probabilmente un modello misto si di- 
mostra vincente in quasi tutte le 
circostanze. 



Istruzione 


Versione Locale 


Versione remota Single Cali 


Versione remota Singleton 


Server firstObject = new ServerO; 








firstObject.Name = "Alice"; 








MessageBox.Show(firstObject.Name); 


restituisce "Alice" 


restituisce nuli 


Restituisce "Alice" 


Server secondObject = new ServerO; 








MessageBox.Show(secondObject.Name); 


restituisce nuli 


restituisce nuli 


restituisce "Alice" 


secondObject.Name = "Beatrice"; 








MessageBox.Show(secondObject.Name); 


restituisce "Beatrice" 


restituisce nuli 


restituisce "Beatrice" 


MessageBox.Show(firstObject.Name); 


restituisce "Alice" 


restituisce nuli 


restituisce "Beatrice" 
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Excel per motore 
C# per pilota 

In questo articolo impareremo ad usare un foglio di lavoro Excel 
attraverso un software scritto in C#. Vedremo come estrarne dati 
e trasformarli inserendoli in un Database 




LI CD LI WEB 

Excel_con_CSharp.zip 
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xcel è uno degli strumenti di Microsoft 
Office più utilizzato per l'analisi dei da- 
Iti. Sebbene il suo punto di forza sia 
quello di poter effettuare calcoli anche abba- 
stanza complessi, nella maggior parte dei casi 
è utilizzato per creare delle semplici tabelle 
utili a raggruppare e visualizzare una serie di 
dati, senza sfruttarne tutta la potenza. 
In questo articolo vedremo come usare un fo- 
glio Excel da un software scritto in .Net (C#), 
capiremo quanto questa accoppiata sia utile e 
quante grane può risolvere. 



PREMESSA 

Nella maggior parte delle applicazioni che 
vengono sviluppate, si ha la necessità di ar- 
chiviare delle informazioni e dei dati per un 
successivo riutilizzo. Si pensi ad un qualsiasi 
sito web che richiede la registrazione degli 
utenti. Le informazioni quali nome utente, 
password, indirizzo di posta elettronica ven- 
gono normalmente registrate in un DataBase 
per poi essere utilizzate, ad esempio, per il 
logon al sito o per l'invio di una newsletter. 
Sebbene un DataBase ci consenta di archivia- 
re ed usare i dati registrati in maniera abba- 
stanza semplice e veloce, spesso non è lo stru- 
mento migliore per effettuare un'analisi 
manuale delle informazioni in esso contenu- 
te. Nel caso si stia utilizzando Microsoft 
Access sarebbe eventualmente possibile rea- 
lizzare dei report o delle maschere (forms) che 
presentino le informazioni in maniera leggi- 
bile ma, in presenza di DataBase più evoluti 
come Sql Server, Oracle ecc., l'operazione non 
è altrettanto semplice. 

Si ricorre quindi a strumenti diversi e, uno 
degli strumenti maggiormente usati è 
Microsoft Excel. 



UNA PANORAMICA 
DI EXCEL 

Excel è un potente foglio di calcolo prodotto 
da Microsoft. Generalmente è rilasciato insie- 
me alla suite di programmi per ufficio 
Microsoft Office, attualmente giunta alla ver- 
sione 2003. Un foglio di lavoro di Excel è orga- 
nizzato per righe e colonne la cui intersezione 
definisce una cella. 

Alle celle di un foglio di lavoro ci si riferisce 
per nome della colonna e numero della riga. 
La prima cella in alto a sinistra del foglio di 
lavoro sarà quindi la cella Al. Teoricamente 
non c'è un limite al numero di righe e colonne 
che ogni foglio può contenere. 
L'insieme dei fogli di lavoro di Excel costitui- 
sce la cartella di lavoro. Come per righe e 
colonne, non c'è teoricamente limite al nume- 
ro di fogli che una cartella può contenere. 
Ogni cella può contenere svariati tipi di dati: 
testo, numeri, valute, data ed ora e, se questo 
non dovesse bastare, è possibile definire dei 
formati personalizzati. 



LA LOGICA DI 
COLONNE E RIGHE 

Uno dei punti di forza del foglio di lavoro di 
Excel è quello di poter eseguire calcoli all'in- 
terno delle celle. Inserendo infatti il simbolo = 
all'interno di una cella, sarà possibile eseguire 
calcoli anche abbastanza complessi i cui valo- 
ri possono essere recuperati da altre celle del 
foglio. Ad esempio, se volessimo effettuare la 
somma dei valori contenuti nelle celle Al e Bl, 
nella cella CI scriveremo =Somma (ALBI). 
Per avere una idea delle operazioni che è pos- 
sibile eseguire all'interno di una cella, è possi- 
bile aprire l'editor delle funzioni dal menu 
inserisci e selezionando la voce funzione. 
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La visualizzazione "tabellare" dei dati, la pos- 
sibilità di inserire formule e grafici, il numero 
illimitato di righe e colonne, fanno di Excel 
uno strumento molto comodo e potente per 
l'analisi dei nostri dati. 



"GIOCHIAMO" COI\l EXCEL 

Nel precedente paragrafo abbiamo visto, in 
maniera molto sintetica, quali sono le poten- 
zialità di Microsoft Excel. In questo paragrafo 
inizieremo a manipolare un foglio di lavoro da 
un programma scritto in C#. 
Vedremo come aprire un file, modificare il 
contenuto di una cella, inserire dei valori, 
modificarne il formato ed infine salvare il 
lavoro. 

Questo esempio ci servirà ad iniziare a pren- 
dere confidenza con il modello di program- 
mazione di Microsoft Excel; tutto quello che 
apprenderemo in questo paragrafo ci servirà 
successivamente per esaminare un caso reale 
di applicazione. 

Apriamo il nostro Visual Studio, creiamo un 
nuovo progetto di tipo "Applicazione per 
Windows" ed aggiungiamo immediatamente 
un riferimento a Microsoft Excel. Per farlo, 
clicchiamo con il tasto destro del mouse sulla 
cartella References e selezioniamo la voce 
"Aggiungi riferimento" . 

Dalla maschera che si aprirà, attiviamo la 
scheda COM e selezioniamo la voce "Microsoft 
Excel xx object Library", dove xx è la versione 
di Excel che avete installato sui vostri PC. 
Una volta referenziati gli elementi di Micro- 
soft Excel, possiamo iniziare a lavorarci su. 
Il primo passo è quello di istanziare un nuovo 
oggetto di tipo Excel.Application che chiame- 
remo xlsApp. Attraverso esso avremo la possi- 
bilità di accedere agli elementi del foglio 
excel, prima tra tutti la cartella di lavoro (Ex- 
cel.Workbook) che nella nostra applicazione si 
chiama xlsWb. 

Abbiamo l'applicazione la cartella di lavoro, 
manca solo il foglio su cui lavorare: Ex- 
cel. Worksheet (xlsWs). Vediamo un esempio 
pratico: 

Excel.Application xlsApp = new Excel. Application(); 
Excel. Workbook xlsWb = xlsApp. Workbooks.Open( 
Environment.CurrentDirectory+@"\test.xls", 0, false, 
5, "", "", true, Excel. XlPIatform.xIWindows, "\t", 
false, false, 0, true, true, false); 
Excel. Worksheet xlsWs = 

(Excel. Worksheet)xlsWb.ActiveSheet; 

Per prima cosa istanziamo un oggetto di tipo . 
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Fig. 1: Aggiunta del riferimento alle librerie di Excel 
nel nostro software 



L'istanza di questo oggetto ci darà successiva- 
mente accesso a tutti gli elementi del foglio 
Excel su cui andremo a lavorare. 
Creiamo dunque una istanza di Excel.Work- 
book (xlsWb) per accedere alla cartella di lavo- 
ro e Excel. Worksheet (xlsWs) per accedere al 
foglio vero e proprio. 

xlsWs.get_Range("Al", "Cl").Font.Bold = true; 

//Rendiamo grassetto il testo delle prime 3 celle 
xlsWs.get_Range("Al", "Cl").Borders.LineStyle = 

Excel. XILineSty le. xlContinuous; //Aggiungiamo 
un bordo alle 3 celle 
xlsWs.get_Range("Al", "Al").Value2 = "Nome"; 
xlsWs.get_Range("Bl", "Bl").Value2 = "Cognome"; 




SUL WEB 



Tutte le caratteristiche 
del prodotto Microsoft 
Excel sono accessibili a 
partire da questo sito: 

http://www.microsoft.com 
/italy/office/excel/prodinfo 
/overview.mspx . 
Per tutti gli altri 
prodotti della famiglia 
Micrsofto Office 
invece, è possibile 
partire da qui: 
http://www.microsoft.com 
/italv/office 



DA E VERSO EXCEL. PERCHE? 



Mi è capitato 
spesso di dover 
spiegare il perché, 
in determinate 
situazioni, è ne- 
cessario muoversi 
da Microsoft Excel 
ad un Data Base e 
perché spesso vale 
anche il discorso 
contrario. La prima 
obiezione che viene 
fatta è: "uso il 
foglio di lavoro per 
organizzare i miei 
dati. Che bisogno 
ho di un Data 
Base?" e, nell'altro 
verso, "ma se ho 
già un Data Base, 
perché devo usare 
Excel?". 

Dare una risposta 
non è sempre sem- 
plice in quanto la 
scelta di un sistema 
piuttosto che un al- 



tro viene molto in- 
fluenzata dalla 
quantità e dal tipo 
di dati da trattare. I 
DataBase, come 
tutti sappiamo, 
servono ad im- 
magazzinare infor- 
mazioni in maniera 
strutturata. 
Sebbene questa 
metodologia 
introduca notevoli 
vantaggi 

(eliminazione della 
ridondanza dei 
dati, organizzazio- 
ne logica, univocità 
ecc.), il dato 
archiviato perde 
spesso di concretez- 
za. Non è raro in- 
fatti imbattersi in 
tabelle composte 
da soli indici! 
Tali dati possono 
essere analizzati 



solo dopo essere 
stati nuovamente 
aggregati attraver- 
so opportune que- 
ry, viste o stored 
procedure ed uno 
dei metodi più 
comuni per 
presentarli è 
appunto quello la 
modalità tabellare. 
Disporre di uno 
strumento che ci 
consente di 
muoverci da una 
piattaforma ad 
un'altra senza 
complesse 
procedure di 
porting, diventa 
estremamente 
vantaggioso per 
noi sviluppatori, in 
quanto potremmo 
creare software più 
vicini alle esigenze 
dei nostri clienti. 
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APPROFONDIMENTI 



Su MSDN è disponibile 
un interessante artico- 
lo dal titolo: 

• UNDERSTANDING THE 

EXCEL OBJECT MODEL 

FROM A .NET 

DEVELOPER'S 

PERSPECTIVE 

in cui viene spiegato il 

modello ad oggetti di 

Excel visto da .net. 

L'articolo comprensivo 

dei sorgenti è 

disponibile a questo 

indirizzo: 

http://msdn, microsoft.com 

/librarv/defaultasp?url= 

/library/en-us/odc 

vsto2003 ta/html/excelobj 

,asp 



xlsWs.get_Range("Cl", "Cl").Value2 = "Età"; 


xlsWs.get_Range("A2", "A2").Value2 = "Michele"; 


xlsWs.get_Range("B2", "B2").Value2 = "Locuratolo"; 


xlsWs.get_Range("C2", "C2").Value2 = "28"; 
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Fig. 2: Il risultato del nostro primo software 

Usiamo xlsWs.get_Range() per selezionare un 
insieme di celle (nell'esempio la selezione va 
dalla cella Al alla cella CI). Sul range di celle 
attivato possiamo compiere tutte le operazioni 
che faremmo manualmente direttamente sul 
foglio come definire dei formati, inserire del 
testo ecc. 

xlsWb.SaveQ; 
xlsWb.Close(false, "", false); 

Quando abbiamo finito, salviamo il nostro file 



Excel e, cosa molto importante, ricordiamoci di 
chiuderlo. 

La nostra prima applicazione è completa. Seb- 
bene sia estremamente semplice, lo scopo è 
quello di chiarire alcuni passi fondamentali ed 
indispensabili prima di lavorare su applicazio- 
ni reali. 



QUALCHE 
TRASFORMAZIONE 

Nel precedente paragrafo abbiamo visto come 
è possibile interagire con dei fogli Excel attra- 
verso un software scritto usando il .Net Fra- 
mework. 
Sappiamo che tutti i produttori di RDBMS 
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Fig. 3: Scelta del formato in cui convertire il foglio 
Excel 



EXCEL E C#: REAL WORLD 



Supponiamo di avere degli 
agenti che stanno 
compiendo un sondaggio di 
gradimento sulla nostra 
azienda. Forniremo ai nostri 
collaboratori un modello 



k'Bo<»aii«i> Excel Manager 



excel che dovranno 
compilare. Alla fine del 
lavoro ci reinvieranno tutte 
le schede in formato 
elettronico che dovremo 
elaborare singolarmente. È 



evidente che, sebbene un 
modello così fatto sia di 
facile lettura, non è di certo 
il formato ideale per una 
elaborazione elettronica. Il 
nostro scopo sarà quello di 



trasformare i dati dalla rap- 
presentazione del modello 
in un unica tabella, più 
semplice da gestire attraver- 
so dei processi 
automatizzati 



Selezione dei fìles 
Cartella Sorgente '. \ 






Din Visual Studio, dopo aver 
aggiunto i riferimenti a Microsoft 
realizziamo un form come in figura. 
Esso conterrà i campi per selezionare la 
cartella in cui risiedono i files, un 
campo in cui specificare il foglio di 
sintesi, una griglia (DataGrid) per la 
rappresentazione dei dati e un log 
immediato. 



folderBrowserDialogl.SelectedPath = 

Environment.CurrentDirectory; 



folderBrowserDialogl.ShowDialog(); 



tbxCartellaSorgente.Text = 

folderBrowserDialogl.SelectedPath; 



ShowFileList(); 



Aggiungiamo al nostro form un ele- 
mento FolderBrowserDialog. Que- 
sto ci consentirà di esplorare le cartelle 
del nostro sistema e di selezionarne una. 
Una volta eseguita la selezione, il tipo di 
ritorno della FolderBrowserDialog sarà 
una stringa che rappresenta il path com- 
pleto della cartella che nel nostro caso 
conterrà i file con i sondaggi compilati. 



private void btnElabora_Click(object 

sender, System. EventArgs e) { 



ArrayList alFiles = new ArrayList(); 



foreach(string f in Directory.GetFiles( 

tbxCartellaSorgente.Text)){ 



alFiles.Add(f);} 



Elabora(alFiles);} 



L'elaborazione dei nostri files si di- 
vide in due step. Il primo consiste 
nella creazione di un elenco dei files da 
elaborare (alFiles). Questo vettore conter- 
rà il path completo di ogni singolo file da 
passare al metodo che si occuperà di ela- 
borarlo. Il secondo step è appunto quello 
di passare l'array al metodo opportuno 
(Elabora(alFiles)). 
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danno la possibilità di importare dati da un 
foglio di testo, i cui campi sono separati da un 
delimitatore standard. Excel ha la possibilità 
di trasformare un foglio di lavoro direttamen- 
te in un file di testo delimitato. Tale funzione è 
accessibile dal menu File, scegliendo la voce 
Salva con Nome e selezionando l'opportuno 
formato. Come abbiamo detto nei precedenti 
paragrafi, l'oggetto Excel.Application che 
istanziamo nel nostro programma ci consente 
di fare, via codice, esattamente quello che fac- 
ciamo manualmente direttamente nel file. 
Per esportare il nostro foglio di sintesi in for- 
mato testo delimitato ci basta fare: 

private void btnExportToTxt_Click(object sender, 

System. EventArgs e){ 
Excel. Workbook xlsWbSintesi = nuli; 
xlsAppSintesi = new Excel. ApplìcationClass(); 
xlsWbSintesi = xlsAppSintesi. Workbooks.Open( 
tbxFileDestinazione.Text, 0, false, 5, "", "", true, 
Excel. XlPIatform.xIWindows, "\t", false, false, 
0, true, true, false); 
xlsWbSintesi. SaveAs(tbxCartellaSorgente.Text+@" 

\sintesi\sintesi.txt", Excel. XI FileFormat.xICSV, 

Type.Missing, Type.Missing, Type.Missing, Type.Missing, 

Excel. XISaveAsAccessMode.xINoChange, Type.Missing, 

Type.Missing, Type.Missing, Type.Missing, Type.Missing); 

xlsWbSintesi. Close(false, "", false); 

} 

ed il nostro file sarà pronto per essere impor- 
tato in un Data Base. 



Nel codice allegato è presente anche una fun- 
zione che trasforma il file di testo in un 
DataSet visualizzabile poi nella DataGrid. 
Avendo a disposizione un DataSet diventa 
estremamente semplice passarlo ad esempio 
ad un servizio web remoto che si occuperà di 
gestirlo. 



CONCLUSIONI 

Uno dei punti di forza dei sistemi Microsoft è 
l'alta integrazione di tutti i software apparte- 
nenti a questa piattaforma. Fino a qualche 
tempo fa il costo di quest'alta integrazione era 
da pagarsi in termini di oggetti com, e dll, 
cosa che comportava una qualche instabilità 
e comunque un overhead del sistema. 
L'avvento di .NET aggira questo ostacolo, ren- 
dendo l'integrazione molto più efficace. In 
questo articolo abbiamo visto come con sem- 
plici passi, usare dei fogli di lavoro Microsoft 
Excel attraverso dei software scritti usando il 
.net Framework. 

Excel è uno strumento di analisi molto poten- 
te e, per i meno esperti, è decisamente più 
semplice e comodo dell'utilizzo di un Data 
Base. Poter "muovere" dati da e verso il foglio 
di lavoro in modo del tutto automatizzato ci 
consente di risparmiare gran parte del tempo 
che si sprecherebbe per rifare le stesse opera- 
zioni manualmente. 

Michele Locuratolo 




Per una guida sulle 
formule utilizzabili in 
Excel, il punto di 
riferimento è il sito 

http://office.microsoft.com 
/it-it/assistance 
/CH062528031040.aspx 
mentre per le funzioni 
si può partire da qui: 
http://office.microsoft.com 
/it-it/assistance 
/CH062528191040.aspx. 




CONTATTA 
L'AUTORE 



L'autore può essere 
contattato attraverso i 
suo blog su 

http://bloqs.mindbox.it 
/mighell e sarà lieto di 
rispondere alle 
domande dei lettori. 



















Excel. Workbook xlsWbSintesi = nuli; 
xlsAppSintesi = newExcel.ApplicationClass(); 
xlsWbSintesi = xlsAppSintesi. Workbooks 

.Open(tbxFileDesti nazione. Text, 

0, false, 5, "", "", true, 

Excel. XlPIatform.xIWindows, 

"\t", false, 

false, 0, true, true, 

false); 

Excel. Worksheet xlsWsSintesi = ( 

Excel. Worksheet) 
xlsWbSintesi. ActiveSheet; 




foreach(string Filename in files){ 

Excel. Workbook xlsWbSondaggio = nuli; 




xlsWsSintesi. get_Range("A"+lastRow, 

"A"+lastRow).Value2 = Nome; 
xlsWsSintesi. get_Range("B" + lastRow, 

"B"+lastRow).Value2 = Cognome; 




xlsAppSondaggio = new Excel.ApplicationQ; 
xlsWbSondaggio = xlsAppSondaggio 
. Workbooks. Open(Filename, 0,true, 5, "", 
"", true, Excel. XlPIatform.xIWindows, "\t", 
false, false, 0, true, true, false); 
Excel. Worksheet xlsWsSondaggio = (Excel 

.Worksheet)xlsWbSondaggio. ActiveSheet; 
Nome = xlsWsSondaggio. get_Range("B2", 

"B2").Text.ToString(); 
Cognome = xlsWsSondaggio. get_Range( 

"D2", "D2").Text.ToString(); 


xlsWsSintesi. get_Range("C"+lastRow, 

"C"+lastRow).Value2 = Indirizzo; 


xlsWsSintesi. get_Range("D"+lastRow, 

"D"+lastRow).Value2 = CAP; 
xlsWsSintesi. get_Range("E"+lastRow, 

"E"+lastRow).Value2 = Città; 
lastRow + + ; 

} //Chiusura del ciclo foreach 
xlsWbSintesi. Close(true, 

tbxFileDestinazione.Text, false); 




^m Tra le prime cose da fare 
■J nell'elaborazione dei f iles è quella di 
aprire il file che raccoglierà 1 dati di sintesi. 
In questo modo infatti, verrà aperto una 
sola volta (prima dell'inizio del ciclo di 
elaborazione dei singoli files) e chiuso alla 
Fine dell'elaborazione. Questo ci consente 
di risparmiare tempo che altrimenti 
mpiegheremo in operazioni di I/O. 




pu II path di ogni file Excel da elabora- 
ci re è contenuto nell'array che abbia- 
mo passato al metodo di elaborazione. 
Dobbiamo quindi aprire ogni foglio Ex- 
cel, recuperare i dati che ci servono (che 
per comodità sono stati associati a delle 
variabili) per poi successivamente inserir- 
i nel file di sintesi che abbiamo aperto 
nello step precedente. 




wm Sempre all'interno del ciclo 
tiM foreach, scriviamo il valore delle 
nostre variabili di appoggio (che 
contengono i dati dei files sorgenti) nel 
Foglio Excel di sintesi. Alla fine di ogni 
ciclo incrementiamo la variabile lastRow 
n modo da passare alla riga successiva. 
Completato il ciclo, salviamo e chiudiamo 
1 file di sintesi. 
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Analisi ai vertici 
dei VideoGames 

Impariamo come sfruttare al massimo l'hardware delle moderne 
schede grafiche utilizzando i motori di Vertex Shader. Una tecnica 
che ci consentirà di realizzare VideoGiochi molto veloci ed elaborati 




Q CD Q WEB 

Vertexshader.2.zip 



■ ' ' ' I 



n 




REQUISITI 



■W.M.WAUJJ, 



p— I Basi di C# 



•\ Microsoft Visual C#, 
U IrrLicht 



^à^à^M^ì 



Tempo di realizzazione 



Molti di voi sapranno che gli oggetti che 
compongono una scena tridimensio- 
nale in un videogame vengono rappre- 
sentati utilizzando la composizione di molti trian- 
goli. Ad esempio una sfera tridimensionale vista al 
microscopio apparirebbe composta da milioni di 
triangoli uniti tra loro che danno l'idea della sfera. 
Ora, volendo deformare la sfera per disegnare ad 
esempio un naso, sarebbe necessario deformare 
ogni singolo triangolo che la compone al fine di 
ottenere la forma desiderata. È anche vero che i 
triangoli sono composti da vertici, e che ciascun 
vertice possiede proprie caratteristiche che lo 
definiscono, oltre alla posizione x,y,z è dotato ad 
esempio di attribuito che ne definiscono il colore, 
la luminosità, eventuali texture. È facile rendersi 
conto che qualunque effetto si voglia applicare a 
una forma tridimensionale passa per la modifica 
degli attributi dei vertici dei triangoli che com- 
pongono la forma. Questo implica per ogni singo- 
lo "frante" di un'animazione milioni di calcoli che 
in tempi passati erano talmente complessi da 
essere quasi impossibili. Immaginate che l'effetto 
più semplice, ovvero applicare una luce su una 
superficie corrisponde a ridisegnare tutti i vertici 
dei triangoli che compongono la superfìcie. Se poi 
si vuole ottenere ad esempio un effetto nebbia in 
movimento, il numero di calcoli diventa impres- 
sionante, se poi vogliamo per caso deformare con- 
temporaneamente o far muovere un oggetto tutto 
diventa molto complesso. Effetti del genere non 
erano possibili in passato. La situazione è radical- 
mente cambiata con l'avvento dei processori 
Hardware inseriti direttamente nelle schede grafi- 
che e che fanno da supporto alla CPU principale 
del computer. In questo modo si riesce a delegare 
una parte dei calcoli ai processori delle schede 
grafiche, che espongono funzioni ottimizzate pro- 
prio per realizzare effetti grafici complessi. Questo 
genere di processori prende il nome di "Vertex 
Shader" . 



COME INIZIARE 



È necessario avere 
installato il DirextX 
SDK. Nessun altro 
componente è richie- 
sto. Se volete provare 
da soli a realizzare 
dei modelli 3D, uno 
strumento piuttosto 
interessante è 
Blender. Si tratta di 
un modeller 3D 
OpenSource. 
Riprodurre gli esempi 
proposti in questo 
articolo è molto 



semplice. È sufficien- 
te utilizzare il pro- 
gramma "EffectEdit" 
contenuto nelI'SDK 
per le DirectX. Si trat- 
ta di un simulatore 
per la gestione dei 
VS. È sufficiente 
digitare il codice, 
salvarlo in un nor- 
male file di testo e 
caricarlo dentro 
EffectEdit per 
simulare i vostri 
effetti. 



I VERTEX SHADER 
E LE DIRECTX 

Ciascun costruttore di Hardware ha integrato 
all'interno delle proprie schede un processore 
"Vertex Shader". Questo non vuol dire che per 
ogni scheda grafica debba essere sviluppato un 
codice particolare per accedere alle funzionalità 
esposte dal processore. A partire dalla versione 
8.0 delle DirectX è stato elaborato uno standard 
per il Vertex Shader, perciò utilizzando le DirectX 
si ha la certezza di scrivere codice perfettamente 
compatibile per tutti i processori VS delle varie 
schede video. 



LE MANI NEL GIOCO 

Fino a qualche tempo fa le funzioni esposte dai 
processori VS erano statiche. Bisognava cioè ac- 
contentarsi di quanto messo a disposizione dalla 
scheda. Ovvero, se la scheda esponeva l'effetto 
nebbia, il programmatore poteva utilizzarlo nelle 
proprie applicazioni, altrimenti no. Inoltre l'ef- 
fetto era programmato dai realizzatori del VS e 
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non dal programmatore del videogioco. Da qual- 
che anno a questa parte gli shader supportati 
dalla schede video sono di tipo "programmabi- 
le". Questo vuol dire che è possibile applicare vir- 
tualmente qualsiasi tipo di effetto mediante sha- 
der, senza limitarsi, come si faceva prima, a quel- 
li predefiniti. Inoltre il fatto che gli shader siano 
manipolati direttamente dall'hardware della 
scheda video, li rende molto veloci, senza impat- 
ti dannosi sulla velocità di rendering della scena. 
È possibile programmare i VS utilizzando un lin- 
guaggio che acceda direttamente all'hardware, 
una sorta di assembler dedicato al 3D. 
Ovviamente un linguaggio di questo tipo è poco 
"maneggevole". Per questo sono stati pensati di- 
versi linguaggi di "alto livello" che permettano di 
scrivere codice in maniera più leggibile e più vi- 
cina a un linguaggio di programmazione tradi- 
zionale. Parliamo di Cg (= "C far Graphics") di 
NVidia e HLSL (= "High Level Shading Langua- 
ge") di Microsoft. Le differenza tra questi linguag- 
gi sono davvero minime e dettate da motivi com- 
merciali più che tecnici. 



UTILIZZIAMO 
DIRECT3D E HLSL 

È possibile programmare un effetto VS inserendo 
il codice in un semplice file testuale che abbia 
estensione ".fx". Il codice siffatto può essere uti- 
lizzato così com'è nella nostra applicazione, 
chiamando le opportune funzioni di Direct3D. 
Per potere provare l'effetto senza dovere lanciare 
però tutta l'applicazione che stiamo sviluppando 
possiamo utilizzare EffectEdit. EffectEdit è un 
piccolo tool presente nell'ambiente di sviluppo 
DirectX (il DirectX 9.0 SDK) che consente di te- 
stare e modificare "al volo" il codice dell'effetto. 
Vengono fornite da questo tool diverse agevola- 
zioni, che consentono di velocizzare di molto il 
lavoro. Ad esempio le seguenti righe di codice: 



DirFromLight che è un vettore composto da 3 
float: inizializzandolo con la stringa UIDirectio- 
nal, EffectEdit creerà a schermo un vettore mobi- 
le che consente di cambiare in maniera facile la 
direzione della luce. 



iniiziALizzAzionii 

Il codice vero e proprio dello shader che andre- 
mo ad analizzare comincia con la definizione 
delle varie sorgenti luminose. Queste sono dei 
vettori composti da 4 float. I valori rappresenta- 
no le componenti RGB (rosso, verde, blu) del co- 
lore e la trasparenza (Alpha). 



// intensità luminosa 


float4 


LightAmbientlntensity 


= { 0.8f, 


0.8f, 


0.8f 


l.Of}; 


float4 


LightDiffuseColor = 


{ 2.0f, 


D.Of, 


O.Of, 


l.Of}; 



La dichiarazione per il colore che verrà assegnato 
al materiale applicato alla mesh è molto simile: 



// colore del materiale 



float4 MaterialDiffuseColor = { 0.4f, 0.4f, 0.4f, l.Of }; 

Concludono questa prima parte di inizializzazio- 
ne le dichiarazioni delle varie componenti che 
servono all'elaborazione della scena 3D, come ad 
esempio la matrice di proiezione o la posizione 
della videocamera. Il tempo è associato alla va- 
riabile Time e, come vedremo, sarà molto utile in 
seguito, per l'implementazione delle animazioni. 

// matrici di trasformazione 
float4x3 World : WORLD; 



float4x3 View 



VIEW; 



float4x4 ViewProjection : VIEWPROJECTION; 
float3 CameraPos : CAMERAPOSITION; 



// tempo corrente in secondi 




float Time : TIME; 



MESH 

E TUTORIAL 

È possibile trovare di- 
verse mesh per la mo- 
difica e l'elaborazione 
dell'esempio proposto 
scaricando il Microsoft 
DirectX 9.0 SDK. Una 
volta installato il pac- 
chetto sarà possibile 
dare un'occhiata agli 
esempi e ai tutorial 
presenti nella cartella 
Microsoft DirectX 9.0 
SDK\Samples\C++\Direct 
3D. Qui è possibile tro- 
vare mesh in formato 
.x nonché diversi file 
".fx" con numerosi 
effetti di esempio da 
analizzare. Sotto Micro- 
soft DirectX 9.0 
SDK\Utilities\Bin\x86 si 
trova invece l'eseguibi- 
le di EffectEdit. 



// modello 3D 



string XFile = "aìrplane\\airplane 2.x" 



// direzione della luce 



float3 DirFromLight < string UIDirectional = "Light 

Direction"; > 
= {0.577, -0.577, 0.577}; 

consentono di caricare un modello 3D nel for- 
mato ".x" di Direct3D. Il trucco utilizzato da Ef- 
fectEdit è semplice: si dichiara una stringa con il 
nome particolare "XFile" e questa viene utilizza- 
ta come modello al posto della mesh di default 
(una sfera) . Questa stringa non avrà alcun effetto 
sul VS quando questo verrà utilizzato all'interno 
della nostra applicazione. Stesso discorso per 



LO SHADER 

Lo shader vero e proprio viene programmato nel- 
la funzione VS0 che restituisce una struttura 
contenente la posizione del vertice elaborato 
(Pos) e il colore risultante dall'illuminazione dif- 
fusa (Diff). La struttura è definita così: 



// struttura pe 


■ l'output del vertex shader 


struct VS_OUTPUT 


{ float4 Pos 


: POSITION; 


float4 Diff : 


COLORO; }; 



La funzione VS() è invece strutturata nel seguen- 
te modo: 
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ii- 



II Vertex shader 



HLSL E CG. 

Abbiamo visto che i 

linguaggi per la 

manipolazione degli 

shader sono HLSL e Cg. 

Ma cosa li differenzia 

tra loro? In realtà poco 

e niente! Cg e HLSL 

sono virtualmente lo 

stesso linguaggio, 

sviluppato in 

cooperazione tra 

Microsoft e NVidia. I 

nomi sono differenti 

soprattutto per motivi 

commerciali. HLSL è 

parte delle DirectX e 

compila solo per 

queste API, mentre Cg 

può compilare anche 

per OpenGL. Di contro 

Cg è molto più indicato 

per le schede NVidia 

piuttosto che per le 

ATI. 



II- 



VS_OUTPUT VS( 



// Posizione dei vertici nello spazio del modello 



float3 InPos : POSITION, 



// Normali dei vertici nello spazio del modello 



float3 InNormal : NORMAL) 



{ VS_OUTPUT Out = (VS_OUTPUT)0; 

// Trasformazione delle posizioni e delle normali 
float3 Pos = mul(float4(InPos, 1), 

(float4x3)World); // posizione 
float3 Normal = normalize(mul(InNormal, 

(float3x3)World)); // normali 
// proiezione della posizione 
Out. Pos = mul(float4(Pos, 1), ViewProjection); 
// illuminazione diffusa 

Out.Diff += CalcDiffuse(Normal, -DirFromLight); 
return Out; } 

Vengono inizializzati come argomenti le variabi- 
li InPos e InNormal con la posizione e la norma- 
le del vertice da elaborare. Queste informazioni 
vengono convertite in coordinate compatibili 
con quelle del "mondo" all'interno del quale è 



posizionato il vertice, tramite le funzioni mul() e 
normalizeO di HLSL. Successivamente viene 
riempita la struttura VSJJUTPUT creata in pre- 
cedenza convertendo la posizione del vertice in 
coordinate proiettive, cioè, in pratica, coordinate 
utili per il disegno a schermo del vertice stesso. 
Questo avviene tramite la ViewProjection. 
Schematicamente il percorso che seguono le 
coordinate del vertice è questo: 

1 All'inizio il vertice è in coordinate "locali", 
lette ad esempio dal file ".x" che contiene la 
mesh. 

2 La coordinate locali vengono convertite in 
coordinate "globali", cioè viene posizionato il 
vertice tenendo conto di tutti gli oggetti della 
scena 3D con le relative traslazioni, rotazioni 
ecc. 

3 Le coordinate globali vengono trasformate in 
coordinate "proiettive" per essere poi dise- 
gnate a schermo. 

Il calcolo dell'illuminazione del vertice viene fat- 
to dalla funzione CalcDiffuseQ che tiene conto 
della normale del vertice e della direzione della 





DIVERSI TIPI DI ILLUMINAZIONE 






float4 CalcHemisphere(float3 Normal, float3 










DirToSky, float Occ) 




// Interpolazione tra il colore del cielo e quello del 






{ 

float4 Hemi = MaterialAmbientlntensity; 




terreno 




Hemi *= lerp(GroundColor, SkyColor, LerpFactor); 
return Hemi; 




// Fattore di occlusione 




Hemi *= (1 - Occ); 




// Calcola il lerp factor 


} 




float LerpFactor = (dot(Normal, DirToSky) + 1) / 2; 






WM Una particolare tecnica di illuminazione 




El Più "nascosto" (occluso) sarà il vertice 




Efl realistica consiste nel calcolare la porzione Efl dalla geometria della mesh, minore luce 


emisferica di illuminazione di ogni singolo riceverà e quindi sarà più scuro quando verrà 


vertice. È possibile inserire nel nostro shader disegnato. Questo codice completa la funzione 


questo codice. CalcHemisphereQ 




float4 CalcSpecular(float3 Normal, float3 
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DirFromLight, float3 EyeToVertex) 

{ 

float3 R = normalize(reflect(DirFromLight, 






>ki J 








Normal)); 






k ^"Àu 








return MateriaISpecularColor * LightSpecularColor 














* pow(max(0, dot(R, -EyeToVertex)), 






W^ t Trh£f ^m\ 








MaterialSpecularPower/4); 
} 
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CM Un altro tipo di calcolo della luminosità del 




WM II risultato delle varie tecniche app 


icate 


KM vertice è quello "speculare". Questa tecnica tàM può arrivare a essere molto realistico se 


utilizza la posizione dell'osservatore (EyeToVertex) visto in movimento. Ricordiamo inoltre che 


per stabilire se la luce si rifletterà completamente generalmente, la presenza di texture migliora di 


sul vertice rendendolo molto chiaro, "a specchio". molto la resa visiva di una mesh. 
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luce. Il corpo funzione di CalcDiffuseQ è il se- 
guente: 



// Modifica la posizione dei vertici 



II- 



II Calcola la luminosità diffusa 



II- 



floar.4 CalcDiffuse(float3 Normal, float3 DirToLight) 
{ return MaterialDiffuseColor * LightDiffuseColor 

* max(0, dot(Normal, DirToLight)); } 

Il colore finale associato al vertice è il prodotto 
tra MaterialDiffuseColor, LightDiffuseColor (defi- 
niti inizialmente) e il valore del prodotto scalare 
tra i vettori passati come argomento. Senza scen- 
dere in spiegazioni articolate ci basti sapere che 
questo valore è tanto più alto quanto le direzioni 
dei vettori operandi sono simili. L'effetto che si 
ottiene è un colore molto chiaro quando il pro- 
dotto scalare è alto e la luce "batte" direttamente 
sul vertice. Il colore assegnato è scuro quando il 
prodotto scalare è negativo: in questo caso l'e- 
spressione max(0, dot(Normal, DirToLight)) vale 
e l'intera moltiplicazione assume valore nullo. 
Completa il codice di questo effetto la dichiara- 
zione della "tecnica" (technique) che utilizza la 
funzione VS() appena definita. Una technique si 
definisce analogamente a come segue: 







// Techniche per 


il d 


segno a 


sch 


ermo 


del modello 




// 


technique Draw 


{ pass PO 


{ VertexShad 


ìr = 


compile 


vs 


? 





VS();} } 









Si usa, come si può vedere, la clausola "compile" 
seguita dalla versione di vertex shader che si uti- 
lizza (in questo caso la 2.0) e il nome della fun- 
zione che elabora il vertice. Viene definito anche 
il nome del "passo" di elaborazione ("pass pO"). 
Ci possono essere uno o più passi in uno shader 
e si può selezionarli singolarmente o nell'insie- 
me tramite le funzionalità offerte da EffectEdit. 



Pos += CalcVertexAnimation(InPos); 

Questa istruzione somma al vettore posizione 
Pos il vettore che è risultato della funzione Calc- 
VertexAnimationO, definita come segue: 






















// Animazioni da 


applicare 


ai vertici del modello 


3D 






















float3 CalcVertexAnimation 


(float3 Offset) 






{ return float3( 


sin(Time ■+ 


Offset. x), sin(3*Time + 








Offset.x), 0) * 


0.2; 


} 



Viene restituito da questa 
funzione un vettore otte- 
nuto manipolando il vet- 
tore-parametro di ingres- 
so con la funzione mate- 
matica seno (sin()) utiliz- 
zata congiuntamente alla 
variabile Time definita 
precedentemente, per ot- 
tenere l'effetto "ondulato- 
rio". Giocando con le va- 
riabili Time e Offset si pos- 
sono ottenere in maniera 
molto semplice svariati ef- 
fetti. Si provino ad inserire, 
ad esempio, le seguenti 
istruzioni in alternativa: 









ama 


^ 




Effettui* -uree code 


Rendersene 


{ 




°^n 




// Calcola la luminosità diffusa 


{ 


S » 


// Vertex shade 


■ 


Rende„n g u S1 n g , e o h n lq ue'D,a W ' 




- 


Effect common ,e S u,t S 


Technique: 




Pass' 


1- 
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Ready Ln 64 Col 7 NUM 



Fig. 1: II nostro esempio in funzione all'interno del 
programma EffectEdit 



return float3( sin(Time + Offset.x), sin(Time + 




Offset.y), 


o); 


return float3( sin(Time) + Offset.x, sin(Time) + 




Offset.y, 


o); 


return float3( sin(Time) * Offset.x, sin(Time) * 




Offset.y, 


o); 



Gli effetti che si otterranno saranno per la mag- 
gior parte strani e difficilmente prevedibili a 
priori. Ecco un motivo per apprezzare un tool di 
sviluppo veloce come EffectEdit. 



ANIMARE IL BIPLANO 

Così com'è il nostro shader non fa nulla (di utile) . 
Illumina il vertice mediante un algoritmo noto di 
diffuse e effettua le trasformazioni "standard" vi- 
ste in precedenza: locale-globale-proiettivo. In 
pratica abbiamo acquistato una Ferrari per te- 
nerla in garage! Liberiamo quindi la potenza dei 
VS con un esempio semplice quanto significati- 
vo. Aggiungiamo un effetto "ondulatorio" al mo- 
dello rappresentato. Per farlo aggiungiamo in- 
nanzitutto la seguente riga di codice nel corpo 
funzione di VS(): 



CONCLUSIONI 

In questo articolo abbiamo visto come creare un 
semplice Vertex Shader utilizzando un linguag- 
gio di manipolazione di alto livello. Abbiamo 
inoltre visto come sviluppare in maniera rapida 
un effetto, visualizzandone immediatamente il 
comportamento tramite il tool EffectEdit. Con un 
po' di creatività e la giusta esperienza il lettore 
riuscirà sicuramente ad ottenere svariati tipi di 
effetti semplicemente modificando di poco il 
codice di esempio. 

Alfredo Marroccelli 
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Due trucchi per 
migliorare VB.NET 

Con List View e Tree View, controlli molto potenti e comodi. 
Creiamo delle classi personalizzate che ci consentono di 
estenderne le funzionalità secondo le nostre esigenze 




CD J WEB 

interfacce.zip 
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REQUISITI 



■JAI.U.J.I.J..' 

[751 -NET livello intermedio 



'i Microsoft Windows 
2» 2000 o XP e Microsoft 
Visual Studio .NET 2003 



Tempo di realizzazione 



ra, la maggioranza di voi, conoscerà il 
controllo "ListView". Lo scopo dell'e- 
sistenza di questo controllo è quello di 
mostrare all'utente dei dati in forma organiz- 
zata. Ad esempio: si può utilizzare per rappre- 
sentare un elenco tale che ciascun elemento 
dell'elenco sia composto di un'icona e un'eti- 
chetta; oppure si può visualizzare in maniera 
tale che vengano mostrati dei dettagli, ad 
esempio: Nome, Cognome, Data di Nascita. 
Le modalità con cui la ListView mostra i dati 
che contiene, sono profondamente influenza- 
ti dalla sua property "View". Ad esempio in 
modalità "List" ciascun elemento appare com- 
posto di un'etichetta e una piccola icona alla 
sua destra. In modalità "Details" ciascun ele- 
mento appare su una linea separata e ciascuna 
linea contiene oltre al nome dell'elemento 
anche dei dettagli che vengono espressi nella 
proprietà "Subltems". Il punto è che per esem- 
pio in modalità "Details" solo la prima colon- 
na della ListView è editabile da parte dell'u- 
tente. Perciò, se per esempio volessimo utiliz- 
zare questo controllo per consentire di inseri- 
re dei dati, la cosa ci costerebbe non pochi 
problemi. In questo articolo estenderemo le 
capacità di una ListView, al fine di renderla 
editabile in ogni sua parte da chi utilizza il 
nostro programma. Aggiungeremo inoltre 
qualche funzionalità di ricerca, e infine effet- 
tueremo lo stesso tipo di modifica anche per i 
controlli di tipo "TreeView". 



LA CLASSE BASE 

La programmazione ad oggetti permette di 
ereditare le caratteristiche di un oggetto base 
per poterlo "specializzare" secondo le proprie 
necessità. Grazie al fatto che .NET è una libre- 



jgffffJB 






Chiave 


| Valore 




Nome: 
Indirizzo: 


| 1 









Fig. 1: L'effetto che vogliamo ottenere è quello di 
rendere editabili i singoli campi di una listview 

ria ad oggetti è possibile applicare questo 
concetto a quasi tutte le sue classi. In questo 
caso la classe in esame è la ListView che mette 
a disposizione proprietà, metodi ed eventi per 
gestire una list view. Il nostro scopo è esten- 
dere questa di modo che abbia il seguente 
comportamento : 

• Quando l'utente effettua un doppio click 
su una cella appartenente a una qualun- 
que colonna, deve apparire un campo di 
testo, editabile e in un primo momento 
contenente il valore della cella selezionata. 
Ovviamente, il campo di testo deve avere 
le stesse dimensioni e la stessa posizione 
della cella. 

• La pressione del tasto invio sulla cella di 
testo deve confermare l'immissione del 
dato e di conseguenza sostituire il valore 
del campo di testo con quello della cella 
selezionata. La pressione del tasto esc o il 
un click del mouse al di fuori del campo di 
testo non deve apportare modifiche alla 
ListView. 

• Al termine della fase di editing, il campo di 
testo deve essere nascosto, e il controllo 
torna alla ListView 

Vediamo, a livello di codice, quali sono i passi 
per specializzare la classe in questione. Prima 
di tutto occorre dichiarare il suo nome e da 
quale classe base ereditare: 
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public class ListViewEnhanced : ListView 

Se la classe definisse dei metodi virtuali, sa- 
rebbe necessario sovrascriverli per specificar- 
ne il comportamento se invocati. Nel caso 
specifico, la classe ListView non dispone di 
entità di questo tipo, per cui nessun passo 
extra sarà necessario per la specializzazione. 
Cominciamo a definire delle variabili private, 
visibili solo all'interno della classe. Utilizzere- 
mo queste variabili come struttura contenen- 
te i dati per definire la posizione e i contenuti 
della casella di testo che ci servirà per gestire 
l'editing della cella selezionata. 



il bordo non tridimensionale, l'invisibilità e la 
funzione che risponderà all'evento KeyPress. 
Successivamente forziamo il controllo List- 
View di base ad assumere alcune caratteristi- 
che come la selezione dell'intera riga al posto 
della sola prima colonna, la vista di tipo "de- 
tails", ad evitare che sia possibile spostare l'or- 
dine delle colonne (cosa che comporterebbe 
molto lavoro extra per ricavarne il vero indice) 
ed, infine, la disabilitazione dell'editing stan- 
dard. Ultima operazione necessaria è quella 
di definire tre funzioni che rispondano agli 
eventi di doppio click, rilascio del tasto del 
mouse e click sulla testata della colonna. 




UB.net 



J 



private TextBox Jextbox; 



private bool _doubleClicked; 



private ListViewItem _ìtem; 



private int 



_subltemlndex; 



Utilizzeremo un valore booleano per sapere se 
l'utente ha effettuato un doppio click, un List- 
ViewItem per tenere traccia dell'oggetto sele- 
zionato all'interno della list view e, infine, un 
intero per memorizzare l'indice della colonna 
selezionata. 

public ListViewEnhanced() 

{ 

_textbox = new TextBoxQ; 

_textbox.Visible = false; 

_textbox.BorderStyle = BorderStyle.FixedSingle; 



_textbox. KeyPress += new 



KeyPressEventHandler(_textbox_OnKey Press); 



this. Controls. Add(_textbox); 



_doubleClicked = false; 



base.FullRowSelect = true; 



base. View = View.Details; 



base.AllowColumnReorder = false; 



base.LabelEdit = false; 



this. DoubleClick += new 



EventHandler(this.ListViewEnhanced_OnDoubleClick); 



this.MouseUp += new 



MouseEventHandler( ListViewEnhanced_OnMouseUp); 



this.ColumnClick += new 



ColumnClickEventHandler( 

ListViewEnhanced_OnColumnClick); 



} 



All'interno del costruttore, ovvero del metodo 
chiamato automaticamente al momento della 
creazione dell'oggetto, inseriamo tutto il co- 
dice necessario ad inizializzare la classe. Pri- 
ma di tutto creiamo un oggetto di tipo text 
box specificando alcune caratteristiche come 



private void ListViewEnhanced_OnDoubleClick(object 

sender, EventArgs e) 

1 

_doubleClicked = true; 



} 



All'interno della funzione che risponde all'e- 
vento del doppio click non faremo altro che 
impostare il booleano a true. 



private void 


ListViewEnhanced_On 
object sender, 


MouseUp( 
MouseEventArgs 


e) 


{ 


if (_doubleClicked) 


{ 


_item = 


GetItemAt(e.X, e.Y); 







Il cuore della classe risiede all'interno del ge- 
store dell'evento MouseUp che si verifica 
quando un pulsante del mouse viene rilascia- 
to. Come accennato all'inizio, dobbiamo dif- 
ferenziare il comportamento del controllo; 
quando avviene un doppio click l'utente vuo- 
le editare il contenuto della cella, quando il 
click è singolo l'utente vuole nascondere il 
campo di testo. Questa differenza può essere 
controllata analizzando il valore del booleano 
impostato durante l'evento DoubleClick. Nel 
caso in cui questo sia stato impostato a true, il 
codice chiama il metodo GetltemAtO esposto 
dalla classe ListView per ricavare l'elemento 
selezionato in base alle coordinate del punta- 
tore del mouse. L'evento MouseUp fornisce 
un parametro di tipo MouseEventArgs che, tra 
le altre cose, contiene proprio le coordinate 
del puntatore del mouse al momento del rila- 
scio del pulsante. 



if 


(_item 


| = 


nuli) 


{ 




Recta r 


gle 


IviBounds; 




int 


su 


DltemX; 




IviBou 


nds 


= Jtem.GetBounds( 
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ItemBoundsPortion.Entire); 

Innanzitutto occorre controllare che il doppio 
click sia stato effettuato su una riga della List- 
View e non, magari, su una zona del controllo 
priva di elementi. Questo si effettua facilmen- 
te controllando che il ritorno del metodo Get- 
ItemAtO non sia uguale a nuli. A questo punto 
con un elemento selezionato valido possiamo 
passare alla fase di calcolo delle sue dimen- 
sioni. Con GetBoundsO è possibile ricavare 
un oggetto Rectangle contenente le dimensio- 
ni del rettangolo che descrive la riga selezio- 
nata. 



subltemX = 


IviBounds 


Left; 






for (int i = 0; 


i<this.Col 


umns 


Count; 


I++) 


{ 



A questo punto comincia l'algoritmo di calco- 
lo dell'indice della colonna a cui appartiene la 
cella selezionata. La coordinata della prima 
colonna corrisponde alla coordinata sinistra 
del rettangolo; poi comincia il ciclo per calco- 
lare l'indice della colonna selezionata. 

ColumnHeader h = this.Columns[i]; 
if (e.X < subltemX+h.Width) 

{ 
_subltemlndex = h. Index; 
Rectangle textRect = new Rectangle(subItemX, 

IviBounds.Top, this.Columns[i].Width, 
IviBounds.Height); 

_textbox.Bounds = textRect; 
_textbox.Text = _item.SubItems[ 

_subItemIndex].Text; 
Jextbox.Visible = true; 



_textbox.BringToFront(); 



_textbox.Focus(); 



subltemX += h.Width; 

Per ricavare la colonna selezionata l'algoritmo 
somma l'ampiezza della colonna ricavata tra- 
mite l'indice del ciclo for con quella memoriz- 
zata all'interno della variabile di appoggio 
subltemX. Se la coordinata X del puntatore 
del mouse al momento del click è maggiore di 
questo valore la variabile di appoggio sarà 
incrementata con il valore dell'ampiezza della 
colonna. Si passerà alla successiva colonna fi- 
no a che non si troverà un valore superiore 
alla coordinata X del puntatore del mouse (a 
meno che il doppio click è stato effettuato su 
una riga ma al di fuori di tutte le colonne). A 
questo punto non rimane che memorizzare 
l'indice della colonna selezionata, calcolare la 
dimensione del rettangolo della cella e impo- 
stare il campo di testo ancora nascosto con 
queste dimensioni. Infine, il campo di testo 
sarà reso visibile e mostrerà il testo contenuto 
nella cella. Il break all'interno del ciclo è fon- 
damentale. Immaginiamo, infatti, di aver se- 
lezionato la cella della prima colonna. La con- 
dizione dell'if sarebbe sempre verificata an- 
che per ogni altra colonna con un conseguen- 
te malfunzionamento del controllo. 

private void _textbox_OnKeyPress( 

object sender, KeyPressEventArgs e) 

j 

switch(e.KeyChar) 

{ 

case (char)Keys. Escape: 

Jextbox.Vìsible = false; 
break; 

case (char)Keys.Enter: 

if (_subltemlndex == 0) 

{ 

Jtem.Text = _textbox.Text; 



break; 



else 



.E UTILIZZARE LA LISTVIEWEIUHAIYCED? 



Dopo tutto questo lavoro sarebbe 
impensabile che l'utilizzo di questo 
controllo comporti delle difficoltà. 
Ed infatti la cosa è molto semplice; 
utilizzando Visual Studio .NET 
occorre seguire questi passi: 



l 



1. Aggiungere un riferimento 
all'assembly che contiene la 
classe ListViewEnhanced sce- 
gliendo il menu Project I Add 
Reference... 



2. Trascinare una list view sopra la 
Windows form 

3. Andare nel codice della Windows 
form e cambiare ogni rife- 
rimento alla classe ListView con 
la nuova classe ListView- 
Enhanced 

La variabile di tipo ListView- 
Enhanced può essere utilizzata 
come una classica list view e 
riempita con i valori opportuni 



_item.SubItems[_subItemIndex].Text = 

_textbox.Text; 



} 



_textbox.Visible = false; 



break; 



ANNULLARE L'EDITING 

L'ultima funzione da analizzare è quella che 
gestisce alcuni tasti speciali che corrispondo- 
no a specifiche azioni come quelle di annulla- 
re l'editing o di completarlo. Se il tasto esc 
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viene premuto durante la fase di editing tutto 
ciò che è stato scritto viene ignorato e la casel- 
la di testo viene nascosta. Se, invece, il tasto 
invio viene premuto durante la fase di editing, 
il programma controlla l'indice della colonna 
della relativa cella selezionata; se è la prima 
colonna, il codice prende il testo direttamen- 
te dall'oggetto ListViewItem, altrimenti utiliz- 
za la collezione Subltems per accedere ai suoi 
sotto elementi. 



RICERCA RAPIDA 
DI UHI ELEMENTO 
DELLA TREE VIEW 

Immaginiamo di aver riempito una tree view, 
con una classica struttura ad albero formata 
da genitori e figli. L'applicazione potrebbe im- 
plementare una ricerca fornendo la possibi- 
lità all'utente di selezionare una voce tra i ri- 
sultati. La selezione della voce in questione 
dovrebbe spostare il cursore alla corrispon- 
dente voce nella TreeView Come fare? 
Verrebbe istintivo pensare ad un ciclo tra tutti 
i nodi della tree view fino a trovare quello che 
ha lo stesso valore di quello selezionato. Ma 
esiste un modo più elegante, funzionale e 
rapido: l'utilizzo di una HashTable. 
L'HashTable è una classe .NET che permette 
di gestire una zona di memoria dove memo- 
rizzare una tabella formata da due colonne: 
chiave e valore. Entrambe le colonne possono 
contenere degli oggetti generici object in 
modo da poter memorizzare qualsiasi cosa, 
da interi a stringhe fino a classi intere. 
Nel caso della tree view si può utilizzare una 
HashTable per memorizzare nella colonna 
valore un oggetto di tipo TreeNode identico a 
quello che si sta inserendo all'interno della 
tree view. Come chiave si deve utilizzare un 
valore univoco che ci possa permettere, poi, 
di rintracciare facilemente questo valore nella 
tabella. 

Immaginiamo di dover realizzare un tool che 
visualizzi le caratteristiche di un file contenu- 
to all'interno di una TreeView. Quest'ultima 
sarebbe formata da un'alberatura simile a 
quella di Gestione Risorse di Windows, dove il 
nodo principale è rappresentato dalla lettera 
associata all'unità del disco e poi i vari rami si 
diffondono per raffigurare l'alberatura del 
disco. In questo caso la chiave della nostra 
tabella potrebbe essere il nome del file com- 
preso di percorso. Questo garantirebbe una 
univocità della voce contenuta nella tabella. 

Hashtable _treenodes = new Hashtable(); 



TreeNode root = tvRoot.Nodes[0]; 



root.Tag 



_treenodes.Add(root.Tag, root); 

Queste poche righe di codice permettono di 
mantenere allineata la tabella in memoria con 
la vista ad albero. Durante l'aggiunta di un 
nodo possiamo utilizzare un'informazione 
univoca come chiave della tabella (in questo 
caso il valore memorizzato nella proprietà 
Tag) e inseririre come valore il nodo stesso. In 
questo modo ricavare l'oggetto all'interno 
della tabella e utilizzarlo per la selezione 
diventerà veramente semplice: 

TreeNode node = (TreeNode)_treenodes[ 

IbResults.Selectedltem]; 
tvRoot.SelectedNode = node; 
tvRoot.SelectedNode.Expand(); 
tvRoot.Focus(); 

L'elemento selezionato da una list box, dopo 
aver effettuato una ricerca, è utilizzato come 
chiave per ricavare il valore corrispondente 
nella tabella Hash in memoria. 




é 



I Esempio TreeView 



B- C: 

Et- My Documenti 



■ Notes.doc 
■Addresses.doc 



FileName: F 



C:\My Docurnents\Addresses.doc 
C:\My Docurnents\Notes.doc 



C:\Mv Docurnents\ToDo.doc 



C:\My Documenti 
C: 



Fig. 1: La Tree view deve essere mantenuta allineata con i dati ricercati 

Questo valore, poi, viene dato in pasto alla 
tree view per selezionare il nodo e provocare 
l'apertura di tutta l'alberatura fino alla sua 
selezione. 



CONCLUSIONI 

La potenza della programmazione ad oggetti 
risiede proprio nella possibilità di estendere 
la funzionalità delle classi base senza dover 
riscrivere il codice a partire da zero, nel nostro 
caso è evidente quanto abbiamo sfruttato la 
OOP creando due comodi controlli. 
Si tratta di due piccoli trucchi che però rendo- 
no sensibilmente la vita più semplice al pro- 
grammatore, laddove l'interfaccia utente deve 
essere adattata ad esigenze specifiche. 

Fabio Claudio Ferracchiati 
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Java e JDBC 

per l'accesso ai dati 

Alla scoperta delle tecniche per utilizzare i database senza problemi 
Poche righe di codice per ottenere un accesso universale ai vari 
server senza doversi preoccupare delle loro differenze 
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La comunicazione fra una generica applicazio- 
ne e il suo database è sempre stata, un grosso 
problema, alcuni l'hanno addirittura simpati- 
camente definita: "La torre di Babele tecnologica". 
Effettivamente spesso ci siamo trovati di fronte a 
database che comunicavano con la nostra applica- 
zione solo ed esclusivamente utilizzando linguaggi 
proprietari, con l'immaginabile conseguenza che 
cambiare database significava anche cambiare il lin- 
guaggio di comunicazione. Una fatica decisamente 
onerosa anche per i programmatori più diligenti, 
figuratevi per noi programmatori Java che siamo 
abituati alla filosofia: "Scrivo una volta, compilo il 
codice e il tutto funziona ovunque.." Nella storia 
SQL ha rappresentato sicuramente un primo passo 
nella facilitazione all'accesso ai database, ma Java 
JDBC API credo che possa essere definito un vero e 
proprio traguardo. Infatti SUN con questa tecnolo- 
gia, ha coniato un vero è proprio standard per far 
comunicare la stessa applicazione con un'ampia 
varietà di database impiegando semplicemente il 
linguaggio SQL. 



COS'È JDBC 

E A COSA SERVE 

Una prima attenzione va sicuramente dedicata al 
nome: "JDBC", secondo SUN non è assolutamente 
l'acronimo di JavaDataBaseConnectivity ma sempli- 
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cernente un marchio registrato composto da quat- 
tro lettere unite fra loro in maniera del tutto casuale. 
Il tutto sarebbe sicuramente credibile se suo stori- 
co antagonista, Microsoft, non avesse adottato il no- 
me "ODBC" OpenDataBaseConnectìvity per defi- 
nire la sua tecnologia standard per l'accesso ai da- 
tabase. Insomma una "J" al posto della "0" una ca- 
sualità decisamente sottile per non essere notata. 
JDBC è un'API, Application Program Interface, quin- 
di un insieme di classi e interfacce Java che consen- 




Fig. 1: Come aprire il progetto nel workspace 



• Scaricare l'ambiente 
di sviluppo eclipse 
all'indirizzo: 
www.eclipse.org vi 
consiglio di utilizzare 
la versione 3.0.3. 
Ricordo che eclipse 
NON va installato, 
per utilizzarlo è suffi- 
ciente scaricarlo e 
lanciare il comando 
eclipse.exe 

• Scaricare il server 
per il database mySql 
all'indirizzo: 
www.mysql.com/ 
Scompattare il file 
mysql-4.1.10a- 
win32.zip e installato 
mediante il Setup.exe 

• Scaricare l'interfac- 
cia grafica per gestire 
il database all'indiriz- 
zo: http://dev.mysql.com 
/downloads/other 
/mysqlcc. ritmi 
Scompattare il file 
mysqlcc-0.9.4- 
win32.zip e 
installato mediante il 
Setup.exe 



• Scaricare i driver 
JDBC per mySql 
all'indirizzo: 

http://dev.mysql.com 
/downloads/connector 
/j/3.1.html 

Scompattare il file 
mysql-connector-java- 
3.L7.zip NON richiede 
alcuna installazione. 

• Copiare la cartella 
del progetto Agenda, 
disponibile sul CD del- 
la rivista, sotto il vo- 
stro Workspace: .... 
eclipse\workspace\[Ag 
enda] 

• Aprire il progetto 
nel vostro workspace 
come mostrato in 
Figura 1 

• Portare fra le librerie 
del progetto il: mysql- 
connector-java-3. 1. 6- 
bin.jar come mostrato 
in Figura 3 

• lanciare l'applicazio- 
ne Agenda seguendo 
le istruzioni di Figura 2 
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Fig. 2: Come lanciare l'applicazione Agenda 

tono l'interazione fra programmi Java e database; 
essendo operante a livello delle chiamate, un pro- 
gramma può accedervi utilizzando semplicemente 
metodi o chiamate a funzioni. In pratica la sua fun- 
zione principale è quella di consentire ad uno svi- 
luppatore Java di connettersi ad un database, invia- 
re richieste SQL, recuperare e gestire i risultati. Sul 
mercato sono disponibili centinaia di driver JDBC, 
almeno uno per ogni database comunemente utiliz- 
zato (MySql, Oracle, Access, ecc.). La sua vera gran- 
de potenza è quella di offrire un'interfaccia standard 
per tutti i tipi di database; questo significa che una 
query JDBC funzionante su MySql potrebbe tran- 
quillamente funzionare anche su Oracle. Perdonate- 
mi, ma in questo caso il condizionale è d'obbligo ed 
è riferito soprattutto alle problematiche che posso- 
no insorgere a causa delle divergenze che esistono 
fra i nomi dei tipi di dato dei diversi database. 
Tranquilli... questa problematica non rappresenta 
comunque una limitazione di JDBC, poiché può 
essere risolta direttamente dal programma utiliz- 
zando i metadati forniti dalla connessione JDBC. È 
importante sapere che esiste anche un driver JDBC 
denominato Bridge JDBC- ODBC. 
Questo, utilizzando ODBC come intermediario, 
consente si utilizzare all'interno di JDBC anche i dri- 
ver ODBC. 




Fig. 3: Come importare del progetto il: mysql-connec- 
tor-java-3.1. 6-bin.jar 



COME FUNZIONA JDBC 

Lavorare con JDBC è veramente semplicissimo. Le 
operazioni necessarie possono essere riassunte in 
quattro passi. Di seguito mostreremo solo la "teoria" 
ma più avanti, per ogni passo, ne vedremo anche un 
esempio pratico. 

1 Caricare il driver JDBC relativo al database che 
si sta utilizzando. Questa operazione viene fatta 
mediante il metodo: Class.forName(nome_dri- 
ver). 

nome_driver - rappresenta, come si può facil- 
mente intuire, il nome del driver che si vuole ca- 
ricare e varia per ogni driver. 

2 Aprire la connessione con il database utilizzan- 
do il driver precedentemente caricato. 
java.sql.DriverManager.getConnection(Con- 
nectionUrì); 

Questa operazione viene svolta mediante una 
chiamata al metodo getConnection() delle classe 
DriverMonager. 

ConnectionUrl - rappresenta l'uri per la connes- 
sione, indica sia tipo di driver che si vuole uti- 
lizzare sia dove andare a recuperare database. 

3 Eseguire le istruzioni SQL. Attivata la connessio- 
ne, la si può utilizzare per create oggetti Sta- 
tement mediante i quali, possono essere creati 
comandi SQL. 

4 Estrarre i risultati restituiti dalle istruzioni SQL. 
Questa operazione si rende possibile utilizzando 
l'interfaccia ResultSet che mette a disposizione 
dei metodi per elaborare le righe restituite ed 
estrarre i valori di ogni singola colonna. 



LE CLASSI 

PER LA CONNESSIONE 

Alcune di queste classi non ci serviranno mai, ma è 
utile ugualmente conoscerle per ottenere una visio- 
ne d'insieme dei meccanismi che regolano JDBC 

• java.sql.Driver - A meno che voi non vogliate 
scrivervi un vostro driver JDBC, non utilizzerete 
ma direttamente questa interfaccia, poiché i 
produttori di driver JDBC lo hanno già fatto per 
voi. Essa rappresenta semplicemente lo start 
iniziale per ottenere una connessione con un 
database. 

• java.sql.DriverManager - Al contrario della pre- 
cedente, è una classe e non un'interfaccia. Il 
suo compito è quello di mantenere la lista dei 
driver registrati per una particolare applicazio- 
ne. Ogni applicazione può registrare uno o più 
driver JDBC diversi fra loro, la classe 
DriverManager, per mezzo del metodo 
getConnectionQ, può "decidere", in base all'uri 
passato come argomento, quale driver utilizza- 
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ESEMPIO DI QUERY PARAMETRICA 



Le query parametriche 
vengono utilizzate in 
tutti quei casi in cui 
l'interrogazione di 
una tabella coinvolge 
l'uso di un parametro, 
un esempio è il 
seguente: 

public static String 

updateUtente() 



"WHERE "); 



.getNomeO) 



{ StringBuffer query = 
new StringBuffer(); 



query.append( 

"UPDATE "); 



query.append("agenda 
.anagraficautenti"); 



query.append( 

"SET indirizzo = ?, 
cap = ? [ ]); 



query.append( 



query.append( 

"nome = ? AND 
cognome = ? AND 
dataNascita = ?"); 

return query.toString(); 

~y 

query.append("SET 

indirizzo = ? [. ]) ? 

questa istruzione indi- 
ca che l'attributo 
"indirizzo" è un para- 
metro della query. 
prima dell'esecuzione 
ho la facoltà di sosti- 
tuire questi parametri 
con i valori reali. 

prepStatment.setString 
(7, updateUtente 



questa istruzione indi- 
ca che al settimo para- 
metro della query vo- 
glio assegnare il valo- 
re updateUtente 
.getNomeO;. Infine l'e- 
secuzione della query 
non avviene più pas- 
sando la Stringa al 
metodo executeUpda- 
te() dell'interfaccia, 
ma avviene richia- 
mando direttamente 
il metodo sull'inter- 
faccia stessa: 

prepStatment.execute 
Update(); 



re, fra quelli registrati, per creare una nuova 
connessione con il database. La classe Driver- 
Manager fornisce due metodi: registerDriverQ e 
deregìsterDrìverO che consentono ad un driver 
di registrarsi o di de-registrarsi dalla lista. 
java.sql.Connection - L'interfaccia Connection 
rappresenta la vera connessione logica con il 
database. Il metodo getConnectionO di 
DriverManager restituisce un oggetti di tipo 



Connection che, grazie ad una serie di metodi, 
consente di svolgere moltissime operazioni, fra 
le quali: preparazione ed invio di statement 
SQL, gestione delle transazioni, gestione degli 
eventuali commit o rollback delle operazioni 
SQL eseguite. 



LE CLASSI 

PER L'ESECUZIONE SQL 

Statement, PreparedStatement e ResultSet rappre- 
sentano alcune delle interfacce fondamental del 
core JDBC 

• java. sql. Statement - Gli oggetti di tipo 
Statement, consentono di eseguire semplici 
query SQL dove per semplici s'intende query 
che non fanno uso di parametri. La classe 
fornisce diversi metodi ma i più utilizzati sono 
sicuramente: 

• executeQuery (String sqlString) questo metodo, 
prende come argomento una stringa SQL e re- 
stituisce un oggetto di tipo ResultSet. Execute- 
QueryC.) può essere utilizzato per tutte le chia- 
mate SQL dalle quali ci si aspetta un valore di ri- 
torno, tipicamente dei dati prelevati da un data- 
base. 

• executeUpdate(String sqlString) ha lo stesso 
funzionamento dell' executeQuery (.. .), l'unica 
differenza sta nel fatto che invece di restituire un 



JDBC IM PRATICA 



Per gli esempi pratici di 
questo articolo, ho deciso 
di implementare una 
semplice applicazione che 

INSTANZIARE IL DRIVER 



permette di gestire i 
contatti di una Agenda. 
Per i soliti motivi spazio 
temporali non vi 

LA CONNESSIONE 



spiegherò nel dettaglio 
tutta l'applicazione, ma 
solo le parti inerenti a 
JDBC, come al solito, i 



sorgenti dell'applicazione 
sono disponibili nel ed 
della rivista. Un buon 
editor Java è Eclipse. 



public class LoadDriver 



{ 



public static void getDriverQ 



{ 



try 



Class. forName("com.mysql.jdbc.Driver" 
).newlnstance(); 



} 



catch(Exception ex) 



{■■■} 



} 



Qmysql.jdbc.Driver rappresenta il 
nome del Driver JDBC utilizzato 
dal database mySql. "Fisicamente" il 
driver è contenuto all'interno del jar: 
mysql-connector-java-3.1.6-bin.jar 
importato nel nostro progetto. 



private Connection getConnectionO 



{ 



Connection connection = nuli 



Try 



connection=(Connection)java.sql 

.DriverManager.getConnection( 

jdbcimysql:// 88.777.222.00 

/agenda?user=root&password = ); 



} 



catch(SQLException ex) 



{...} return connection; 



} 



□ Questo metodo restituisce una 
connessione attiva con il 
database "agenda" dell'applicazione 
Agenda, viene quindi richiamato ogni 
volta che abbiamo la necessità di 
interagite con il database. 



I COMANDI SQL 



public boolean 


insertNuovoUtente( 

DataUtenteStruct utente) 


{ Statement statment = nuli; 


Connection 


con = getConnectionO; 


try 


{ ... 


String query = QuerySQL.insertUtente( 

utente); 


statment 


= con.createStatement(); 


statment 


executeUpdate(query); 


... } 


catch(SQLE 


xception ex) 


{■■■} 


} 



H Inseriamo un nuovo utente nel 
database. Entra in gioco un'altra 
classe molto importante per la nostra 
applicazione ed è la: model. Query SQL, 
all'interno di quest'ultima vengono 
implementate tutte le query. 
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LA SINTASSI 

DI GEI-CONNECTION 



::mysql ? 
Identifica quale driver 
JDBC utilizzare. 

1188.777.222.00 ? 
Identifica l'indirizzo 
della macchina dove 
gira il server, quello 
che vedete è 
l'indirizzo di una mac- 
china test 

lagenda ?user=root& 
password^ ? 
Identifica il nome del 



database al quale con- 
nettersi {agenda), se- 
guito dall'autentica- 
zione dell'utente che 
si sta connettendo 
(user e password). In 
Pratica: 
"Connettiti al 
database posto sotto 
la macchina 1188.777 
.222.00 con il driver 
jdbamysql con l'uten- 
te root, la password 
non è specificata" 



oggetto di tipo ResultSet, restituisce il numero di 
righe per le quali ha effettuato l'operazione di 
update. Un tipico utilizzo di questo metodo è per 
eseguire query di UPDATE e di INSERT. 
execute(String sqlString) viene utilizzato in quei 
casi in cui non si sa se eseguire un execute- 
Query(....) o updateQuery(....), questo tipica- 
mente avviene quando lo Statement SQL viene 
creato dinamicamente, se l'esecuzione della 
query restituisce delle righe allora il metodo re- 
stituisce true, altrimenti restituisce false. Infine, 
con il metodo getResultSetO è possibile preleva- 
re tutte le righe restituite dalla query. 
java.sql.PreparedStatement - Un oggetto di 
tipo PreparedStatement consente di scrivere 



delle query con parametri di input, l'interfaccia 
fornisce dei metodi in grado di sostituire tali 
parametri con dei valori reali. Essa estende l'in- 
terfaccia Statement e di conseguenza ne eredita 
tutte le funzionalità 
• java.sql.ResultSet - Un oggetto ResultSet, rap- 
presentati risultato di una query. Esso può esse- 
re schematizzato in forma tabellare dove sulle 
righe troviamo gli oggetti selezionati dal data- 
base, mente sulle colonne gli attributi di questi 
oggetti. L'interfaccia fornisce tutta una serie di 
metodi in grado di estrarre ogni singolo attribu- 
to per ogni singolo oggetto (riga). 

ResultSet rs = statment.executeQuery(query); 

I metodi per estrarre i singoli attributi possono 
essere schematizzati nel seguente modo: 

rs.get Type(int | String) 

dove l'argomento può rappresentare o il nume- 
ro o il nome della colonna, sempre facendo rife- 
rimento ai nomi e ai numeri presenti sul databa- 
se, mentre il suffisso type rappresenta in quale 
tipi dato (String, int, ecc..) mi aspetto che venga 
restituito il risultato. Tutto quello che avete letto 
fin qui è illustrato in sei semplici passi nel box a 
fondo articolo 

Valentina Muraglia 
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DEFINIAMO LA QUERY 



public static String insertUtente( 

DataUtenteStruct utente) 



StringBuffer query = new StringBuffer(); 



query.append("INSERT INTO "); 



query.append("agenda.anagraficautenti"); 



query.append( "(nome, cognome, [ ]); 



query.append( "VALUES ('"); 



query.append(utente.getNome() + '", \n"); 



query.append( '"" ); 



query.append(utente.getCognome() 
+ "', W); 



query.append( ")" ); 



return query.toString(); 



Q Molto semplicemente abbiamo 
creato una stringa contenente i co- 
mandi SQL che ci servono per manipola- 
re il database. Si tratta di un metodo co- 
modo che ci consente di passare questi 
comandi alla classe model.query che 
abbiamo visto in precedenza. 



QUERY PARAMETRICHE 



public boolean update( 

DataUtenteStruct updateUtente) 



{ Connection con = getConnection(); 



PreparedStatement prepStatment = nuli 



try 



{ String query = QuerySQL.updateUtenteQ; 



prepStatment = (PreparedStatement 

)con.prepareStatement(query); 



prepStatment. setString( 

1, updateUtente. getIndirizzo()); 



prepStatment. setString( 

7, updateUtente. getNome()); 



prepStatment. setString( 

8, updateUtente. getCognome()); 



prepStatment. executeUpdateQ;} 



catch(SQLException ex) 



{■■■} 



} 



H Molto simile al suo quasi omoni- 
mo Statement, ci consente di 
eseguire delle query parametriche. La 
differenza sta nel fatto che la query 
non viene più costruita direttamente 
con i valori reali, bensì con parametri 
identificati dai vari '?' 



I RISULTATI 



public List searchUtenti( 

DataUtenteStruct utente) 



ResultSet resultSet = nuli 



resultSet = (ResultSet) 

statment.executeQuery (query); 



while(resultSet.next()) 



{ 



DataUtenteStruct singoloUser = new 
DataUtenteStructQ; 



singoloUser.setNome( 

resultSet.getString("nome")); 



singoloUser.setNome( 

resultSet. getString(l)); 



singoloUser.setCognome( 

resultSet. getString("cog nome")); 



} 



Qll ResultSet rappresenta 
l'oggetto che "fisicamente" ci 
consente di estrapolare il risultato di 
una query. Un suo utilizzo completo è 
visibile nel metodo searchUtenti(...) 
sempre nella nostra classe: 
model. BcAgendaModelQ 



http://www.ioprogrammo.it 



Giugno 2005/ 57 ► 



Speech API SDK 4.0 ■ ▼ VISUAL BASIC 



Quel chiacchierone 
di Visual Basic 

Se in altri ambienti realizzare applicazioni che usano la sintesi vocale 
può sembrare particolarmente complesso, in VB questa tecnica è 
ormai consolidata. In pochi passi si realizza un'applicazione completa 



Ho iniziato ad usare la SAPI (Speech Appli- 
cation Programming Interface) per svi- 
luppare un'applicazione dedicata ai non 
vedenti che potevano, in tal modo, scrivere i pro- 
pri documenti e sentirli leggere dal PC. 
Naturalmente questo, per quanto sia lodevole, è 
soltanto una delle numerose applicazioni in cui 
potrebbe avere senso utilizzare un motore di sin- 
tesi e riconoscimento vocale. 
Sta a voi individuare i campi d'applicazione. 



IL KIT DI SVILUPPO 

Per sviluppare un'applicazione di "sintesi vocale" 
abbiamo bisogno del kit Microsoft Speech SDK 
contenente: 

• le SAPI (Microsoft Win32-compatible speech 
application programming interface); 

• un motore per il riconoscimento vocale (Mi- 
crosoft continuous speech recognition engine); 

• un motore per la sintesi vocale (Microsoft con- 



catenateci speech synthesis engine) conosciuto 
anche come text-to-speech (TTS) engine. 

Il kit fornisce inoltre alcuni strumenti di sviluppo 
per la verifica e il test dello sviluppo, alcuni esem- 
pi e la documentazione sulle principali caratteri- 
stiche dell' SDK. 

Per sviluppare la nostra applicazione abbiamo 
usato la versione SDK contenente la SAPI 4.0 che 
supporta l'automazione OLE. Questo fa sì che 
non solo i linguaggi come C/C++ possono usare 
le SAPI, ma anche quei linguaggi come Visual 
Basic, C# e Javascript capaci di accedere agli 
oggetti di automazione. 



COME FUNZIONANO 
LE API NEL TTS 

Il programma fa uso del motore delle SAPI per 
eseguire una sintesi vocale (text-to-speech) che 
consiste nel passaggio tra testo -> formato bina- 
rio->parlato. In particolare la nostra applica- 
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COME INIZIARE 



Affinché il nostro pc parli, è ne- 
cessario scaricare ed installare 
il kit SDK 4.0 direttamente dal- 
l'indirizzo http://download 
.microsoft.corn/download 
/speechSDK/lnstall/4.0a/WIN98 
/EN-US/SAPI4SDK.exe. oppure 
possiamo scaricare manual- 
mente i singoli componenti 
che ci interessano. In particola- 
re i files da installare sono: 
• spchapi.exe: questo file, 
scaricabile dal seguente in- 
dirizzo http://download 
.rnicrosoft.com/download 
/speechSDK/lnstall/4.0a 



/WIN98/EN-US Zspchapi.EXE . 
contiente le SAPI che fanno 
interagire l'applicazione 
con il motore TTS. 
Msagent.exe: questo file, 
che possiamo scaricare 
all'indirizzo http://activex 
.microsoft.com/activex 
/controls/aqent2/M Saqent.exe. 
permette di usare il compo- 
nente Microsoft Agent 2.0 
che utilizzeremo all'interno 
della nostra applicazione. 
Gli utenti di WINDOWS 
XP/2000 /Me possono 
saltare questo passo dato 



che i componenti del 
Microsoft Agent sono già 
installati per questi sistemi 
operativi. 

Se facciamo parlare il nostro 
PC noteremo un forte accento 
inglese, questo perché la piat- 
taforma è progettata con la 
lingua inglese di default. 
Se vogliamo far parlare il no- 
stro agente con un accento ita- 
liano dobbiamo scaricare due 
files del TTS: 

• lhttsiti.exe: che troviamo 
all'indirizzo http://activex 



.microsoft.com/activex 
/controls/aqent2/l httsiti.exe 
• AgtX0410.exe: che troviamo 
all'indirizzo 

http://activex.microsoft.com 

/activex/controls/aqent2 

/AgtX0410.exe 

Esistono diversi agent charac- 
ter (alcuni di questi sono il ge- 
nio o il cane) che oltre a farci 
ascoltare il testo, lo scrivono 
all'interno di un "balloon". Ne 
possiamo scaricare diversi, in 
formato .acs dall'indirizzo 
www.msagentring .org/chars.htm 
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I TUOI APPUNTI 



zione controlla le attività di sintesi attraverso 
l'interfaccia ISpVoice Component Object Model 
(COM) con cui prima crea un oggetto ISpVoice e 
successivamente richiama il metodo ISpVoice:: 
Speak per tradurre vocalmente un qualsiasi te- 
sto. 

Il metodo ISpVoicer.Speak opera in due moda- 
lità: 

• Sincrona: Termina solo quando l'applica- 
zione ha completamente finito di parlare; 

• Asincrona: Termina immediatamente e par- 
la come se fosse un processo di background. 

In modalità asincrona, se scriviamo del testo 
nuovo oltre quello che già avevamo, possiamo 
avere due effetti: in un caso, il parlato può esse- 
re interrotto e ascolteremo il testo appena in- 
serito; nell'altro caso il testo sarà automatica- 
mente accodato a quello che stiamo già ascol- 
tando. 



uni ESEMPIO 

DI REALIZZAZIONE 

Realizzare un'applicazione per la sintesi vocale 
non è certamente un'impresa difficile, la par- 
ticolarità consiste nel sviluppare funzionalità 
avanzate per la gestione del testo. Analizziamo il 
codice usato per realizzare le basi della nostra 
applicazione, successivamente mostreremo co- 
me renderla più completa. Per usare il motore 
TTS dobbiamo inserire nel nostro progetto il 
componente Microsoft Agent Control 2.0. Fatto 
ciò dichiariamo come oggetti globali all'interno 
della nostra form un attore, che nell'esempio è il 
mago merlino, ed una costante che definisce il 
percorso del folder dove si trova il file merlin.acs. 

Dim merlin As IagentCtICharacterEx 



Const DATAPATH 



"merlin.acs" 



Nel caso in cui stessimo lavorando con Win- 
dowsXP, la costante DATAPATH corrisponde a 



ECCO COME PARLA IL NOSTRO COMPUTER 



Utilizza questo spazio per 
le tue annotazioni 



CREIAMO UN NUOVO PROGETTO 



CARICHIAMO L' AGENT 



File Modifica Visualizza Progetto Formato Debug Esegui Query 



^^l3.'TBis;H*i%e*4^o ► il 



rp - 



Generale | 



[Vi 

A [Si 

□ _l 

m m 



*a Sintesi vocale 



DDal menu File di Visual Basic selezioniamo 
Nuovo Progetto e scegliamo il tipo EXE 
Standard. Cambiamo il nome alla Formi in 
Sintesi vocale e diamo alla caption il valore 
Sintesi Vocale. 



INSERIAMO LA CASELLA DI TESTO 





Qusry Diagramma Strumenti Aggiunte Finestra ? 




||»-iSfB|i*BU*«m|"»| . 


Il ■Htf*Sl!f*9A|'H 240, 


M iBffiHJ* 


IfflBS 1 l\ 






c ,„„i, | 

A W\ 






-.-:.- .^ 








n 


□ -1 










1= ff 










BB 










*>*> % 










è a 










□ m 










@ ^ 










il 










Sì A 











Inseriamo la casella di testo in cui andre- 
mo a scrivere e la chiamiamo Textl. Siamo 
pronti per scrivere il codice della nostra applica- 
zione. 



Controlli 



Finestre di progettazione j Oggetti inseribili | 



□ Kodak Irnage Thumbnail Control 

□ Mabry Internet Pingui ActiveX Control 
MassRAS ActiveX Control module 

□ M icrosc ivie Control 

□ Microsoft Calendar Control 8.0 

□ Microsoft Chart Control G.O (SP4) (OLEDB) 

□ Microsoft Comm Control 6.0 

□ Microsoft Common Dialog Control 6.0 (SP3) 

□ Microsoft Data Bound Grid Control 5.0 (SP3) 

□ Microsoft Data Bound Lisi Controls 



3 



^ 




-eh 


JJ 


jA 





Gi- 


m] 


°5" 


gi 


fr, 


% 




E] 


m 



Dal menu Progetto selezioniamo la voce 
Componenti e clicchiamo su Microsoft Agent 
Control 2.0. Comparirà l'icona dell'agente nella Ca- 
sella degli strumenti. Quindi clicchiamo sull'icona 
dell'agent e importiamola all'interno della form. 



PROVIAMO L'APPLICAZIONE 




□ Nella versione più semplice, la nostra 
applicazione apparirà con questo layout. 
Come vediamo l'attore è il mago ma è possibile 
sceglierne anche altri. 
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c:\WINDOWS\Msagent\char, in questa cartella 
saranno copiati i personaggi che traducono in 
parole il testo scritto. Più avanti vedremo che è 
possibile creare dei nuovi personaggi che do- 
vranno essere salvati all'interno di questa cartella 
per poter essere utilizzati. Nella Form_ LoadQ cari- 
chiamo il personaggio seguendo il DATAPATH spe- 
cificato prima ed assegnamo alla variabile merlin 
le proprietà di questo attore. Con la stringa mer- 
lin.Balloon.Style = False nascondiamo il balloon in 
cui compare il testo che scriviamo nella casella di 
testo, mentre con merlin.LanguagelD = &H410 
specifichiamo che il mago Merlino dovrà parlare 
in italiano. L'ultima stringa ci permette di visualiz- 
zare il mago, contemporaneamente apparirà un'i- 
cona nella system tray. 



Private Sub Form_Load() 


Agenti. Characters.Load "merlin' 


, DATAPATH 


Set me 


rlin = Agenti. Characters(' 


merlin") 


merlin 


Balloon. Style = False 




merlin 


LanguagelD = &H410 




merlin 


Show 




End Sub 



Far parlare la nostra applicazione è veramente 
un gioco da ragazzi, basta infatti associare all'e- 
vento di pressione di un tasto l'azione mer- 
lin. Speak. 

Private Sub Textl_KeyPress(KeyAscii As Integer) 
merlin. Speak "\Spd = 180\" + Chr(KeyAscii) 
End Sub 

All'interno della procedura abbiamo specificato 
la velocità con cui deve parlare il nostro agente 
vocale (Spd=180) e il carattere che deve pronun- 
ciare (Chr(KeyAscii)). Quando digiteremo del 



UNA VERSIONE PIÙ COMPLESSA 




Possiamo realizzare qualche funzione che 
agisce sul testo più che sul parlato. Con 
poche righe di codice l'utente sceglie il tipo, lo 
stile e la dimensione dei caratteri. Si può notare 
come non sia visibile l'attore, ma non è 
nascosto: è invisibile. 



testo ascolteremo i caratteri corrispondenti ai 
tasti che stiamo premendo. Bisogna dire però il 
codice proposto è incompleto. Infatti se premia- 
mo la barra spazio o il tasto invio, oppure il tasto 
cancella, non otterremo alcun risultato: il nostro 
agente non parla. Possiamo risolvere questo pic- 
colo inconveniente con una semplice operazio- 
ne. Sempre all'interno della procedura 
Textl_KeyPress( KeyAscii As Integer) definiamo 
una serie di controlli If-Then con i quali verifi- 
chiamo se il tasto premuto corrisponde a barra 
spazio, invio o cancella. 




If KeyAscii = 


13 Then 






merlin. Speak 


"\Spd = 


= 250\\Chr= 


"Monotone' 


"\invio" 


End If 


If KeyAscii = 


32 Then 






merlin. Speak 


"\Spd = 


= 250\\Chr= 


"Monotone' 


"\spazio" 


End If 


If KeyAscii = 


8 Then 








merlin. Speak 


'\Spd = 


250\\Chr=" 


Monotone'" 


\cancella" 


End If 


If KeyAscii <> 8 And KeyAscii <> 32 And KeyAscii 

<> 13 Then 


merlin. Speak 


"\Spd = 


= 180\" + Ch 


r(KeyAsciì) 




End If 



Per ogni caso specifichiamo la velocità di pro- 
nuncia, il timbro e la parola associata al tasto 
che stiamo digitando. A questo punto vogliamo 
ascoltare tutto quello che abbiamo scritto nella 
casella di testo. Per far questo basta associare 
ad un tasto di funzione (per esempio FI) la pro- 
prietà merlin. Speak Textl.Text ed agganciare 
questa funzionalità all'evento Textl_KeyUp. 

Private Sub Textl_KeyUp(KeyCode As Integer, 

Shift As Integer) 
If KeyCode = 112 Then v 112 corrisponde al tasto FI 
If Textl.Text <> "" Then 



merlin. Speak Textl.Text 



End If 



End If 

Possiamo pensare di sviluppare altre funziona- 
lità che ci fanno ascoltare il testo con la punteg- 
giatura, gli spazi, i tag di invio ecc. che troviamo 
all'interno del testo. Queste informazioni sono 
sicuramente a supporto di un utente non ve- 
dente. 



AGEIUT CHARACTER 
EDITOR 

Anche se l'editor non è compreso nel SDK, è 
comunque uno strumento su cui spendere due 
parole dato che è utile perché possiamo creare i 
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nostri attori preferiti con le caratteristiche gra- 
fiche e vocali più adeguate alla nostra applica- 
zione. Nel caso specifico mi occorreva un cha- 
racter invisibile sullo schermo e nella system 
tray. Sono riuscito a realizzarlo con questo sem- 
plice editor che dà, comunque, la possibilità di 
associare numerose azioni al nostro personag- 
gio. Ma vediamo come creare un personaggio 
invisibile così come lo desideravo. 



1 



Per iniziare dobbiamo scaricare l'editor 
direttamente dall'indirizzo http://www.mi- 
crosoft.com/msagentldownloadsldeveloper.a 
sp ed installarlo sul nostro pc. Una volta 
avviato, il programma si presenta con la 
schermata riportata in Figura 1. 



P£3 Character - Microsoft Agent Character Editor 



File Edit Help 



Bey a § »*■ x"" 



E]-® Character 
i-^( Animations 
É-ft States 



Properties Voice | 
-General Information 

ILanguage: fltaiian 



Description: 



Extra Data: 



■Output Options — 
I Supporti stand. 



Eliminiamo l'opzione Use word balloon e 
spuntiamo la voce Use synthesized speech 
for voice output. Così facendo il testo non 
sarà stampato a video ma sarà parlato dal 
nostro personaggio. 

Come riportato in Figura 2, sfogliamo la 
sezione Voice e selezioniamo dalla list box 
Name il tipo di voce che ascolteremo; pos- 
siamo scegliere una timbro maschile o fem- 
minile. 



J< O Ca 



Properties Voice | 
Voice — 
Name: 



Aduli Male #1 rtalian (L4H1 



Mode ID: {7EF717G1-A92D-11D1-B17B-0D20AFED142E} 

Vendor: Lernout & Hauspie 

Language: rtalian (rtaly) 
Stille: 



Casual 



Gender: iMale 
Age: lAdult 



4 Creiamo una nuova animazione ciccando 
sull'icona SI ; si aprirà la finestra rappresen- 
tata in Figura 3. Nella box Assign to state 
spuntiamo le proprietà Hiding e Speaking; il 



nostro personaggio sarà nascosto ma par- 
lerà. Di conseguenza gli States Hiding e 
Speaking nelle proprietà generali del nostro 
character saranno associate all' Animationl 
che abbiamo appena creato. 



F£3 Character - Microsoft Agent Character Editor 



File Edit Help 



Q cf H|& 



"te E I X ^ ^ 



lJ 



Eh® Character 
- @ .-: ìimaii ons 

! |1| Animation 1 

É-g, States 



Properties I 
Animation Name: lAni 
Return Animation: |[J2 
Assign to State: □ 





Adesso realizziamo un New Animation Fra- 
me cliccando sull'icona Ó , si aprirà la fine- 
stra rappresentata in Figura 4. Nella finestra 
General aggiungiamo un'immagine in for- 
mato .bmp che è l'unico supportato. Per 
avere un personaggio invisibile, bisogna pri- 
ma creare un'immagine trasparente che as- 
soceremo in questo momento. 



[eS Character - Microsoft Agent Character Editor 



File Edit Help 



13 e* H I K I * 



fe I X *~> r* 



J 



B-® Character 
- @ .-■"limations 
B-fH .^nimation 1 
T....Q | 

EÉ'"S States 



General | Branching| 



|.%iimation 1 - Frame 



Dopo aver assegnato l'immagine possiamo 
creare il nostro personaggio selezionando 
dalle proprietà File il comando Build Cha- 
racter. Infine decideremo di salvare il nostro 
file nella cartella c:\WINDOWS\msagent 
\char\characterl.acs. 



CONCLUSIONI 

Nonostante l'applicazione sia semplice da rea- 
lizzare il potenziale di utilizzo è molto elevato 
specie se rivolta ad un particolare target di 
utenti. Possiamo arricchire il nostro program- 
ma con funzionalità elevate che danno valore 
aggiunto alla sintesi vocale. In questa versione 
ho usato le SDK 4.0 ma la Microsoft distribuisce 
anche la versione più aggiornata SDK 5.1. 



Egidio Lancione 
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Attenzione 
a quell'uncino 

Ci avventuriamo nei meandri del sistema operativo, per conoscere 
meccanismi che regolano la gestione degli eventi. Sapevate di poter 
modificare il comportamento del mouse a vostro piacimento? 




Lj CD 

Hooks.zip 



J WEB 



immmm 



n 




REQUISITI 



HM.umm 



— conoscenze elevate 
diOt 



Li 



, NET framework SDK, 
VisualStudio.NET, 
Windows 
98/ME/2000/XP/2003 



sa a laa 1=3 e 



Tempo di realizzazione 



Ri 



iveliamo subito che lo scopo di questo arti- 
colo è scrivere un'applicazione di contachi- 
. lometri per il mouse. Ci pensate a quanti chi- 
lometri percorre ogni giorno? Sono curioso di sape- 
re quanti e mi sono messo in testa di scrivere questa 
applicazione. Ma, mentre scrivevo, mi sono reso 
conto che la cosa non è per niente banale. Il movi- 
mento del mouse è infatti un evento del sistema 
operativo. Cioè ogni volta che il mouse viene mosso, 
questo evento viene comunicato al sistema, che lo 
gestisce. Normalmente, ad esempio, la freccetta che 
indica il puntatore del mouse si muove sullo scher- 
mo. Perciò la mia prima idea è stata intercettare l'e- 
vento scatenato dal movimento del mouse e gestirlo 
al posto del sistema. E già questo non è stato un 
compito proprio facile. A questo punto mi sono 
anche reso conto che se mi sostituivo al sistema. 
Avrei dovuto gestire una procedura che contasse i 
chilometri percorsi dal mouse ma anche una proce- 
dura che spostasse puntatore del mouse sullo 
schermo al posto mio. Il che è decisamente noioso. 
Vogliamo provare ad estendere il problema? 
Pensiamo ad un'applicazione che conti il numero di 
volte che un tasto viene premuto sulla tastiera. An- 
che qui ci sarebbe da intercettare l'evento e poi ge- 
stirlo, e gestire anche i compiti classici di sistema. 
Esiste un modo semplice per creare applicazioni di 
questo tipo? La risposta è si! Si chiama "Gestione 
degli Hook di sistema" ed è quello di cui parleremo in 
questo articolo. 



COS'È uni HOOK 

Un hook è un meccanismo del sistema operativo 
mediante il quale è possibile intercettare particolari 
eventi di sistema, senza per questo impedire che essi 
giungano alle applicazioni che normalmente li 
gestiscono. Ad esempio è possibile intercettare mo- 
vimenti e click del mouse, o anche le pressioni dei 
tasti, o ancora eventi come l'apertura di una finestra, 
suo ridimensionamento, e chi più ne ha più ne 



metta. È possibile, associare dunque delle funzioni 
di callback, invocate automaticamente quando un 
evento ben definito si verifica, e dunque intrapren- 
dere particolari azioni. 



CATENE DI HOOK 

In realtà, ogni qualvolta sistema rivela un evento, 
lo intercetta tramite un Hook. A questo punto viene 
dato via a una sequenza di azioni che gestiscono 
l'evento. Questa sequenza di azioni prende il nome 
di "Catema di Hook". Perciò ad esempio premendo 
un tasto sulla tastiera, questo evento viene rilevato 
dal sistema e il controllo passa alla catena di Hook 
che lo gestisce. Va da sé che se voglio contare quanti 
chilometri percorre il mouse, devo registrare un 
Hook nella catena di Hook che gestisce l'evento dello 
spostamento del mouse. In questo modo mio hook 
gestirà una procedura che memorizza lo spazio per- 
corso, e appena questa procedura avrà termine il 
controllo passerà all' hook successivo. 
Ciascun evento di sistema viene gestito da una cate- 
na di hook separata. La catena di hook prende il 
nome in inglese di Hook Chain. 



LE MANI NEL CODICE 

Per sfruttare gli hook è dunque necessario creare 
una hook procedure ed inserirla nella hook chain re- 
lativa. Una procedura di hook deve rispettare la se- 
guente firma: 

LRESULT CALLBACK HookProc(int nCode, 

WPARAM wParam, LPARAM IParam); 

Il nome della procedura, in questo caso HookProc, è 
naturalmente definibile a piacimento dallo svilup- 
patore. Il valore intero nCode, è un codice che deter- 
mina l'azione da svolgere, e che dipende dal tipo di 
hook, cioè per ogni tipo esistono dei possibili valori 



»- 66 /Giugno 2005 



http://www.ioprogrammo.it 



Gestire gli Hook con C# ■ ▼ ADVANCED EDITION 



che nCode può assumere. Gli argomenti wParam ed 
IParam contengono dei valori che dipendono anco- 
ra dal tipo di hook, ma in genere contengono infor- 
mazioni aggiuntive su un messaggio. Per installare 
una hook procedure in una hook chain, ed al con- 
trario per rimuoverla da essa, TAPI di Windows for- 
nisce due funzioni, SetWindowsHookEx ed Unhook- 
WindowsHookEx. La prima funzione installa una 
hook procedure in testa alla relativa hook chain. 
Quando si verifica un evento che è associato ad un 
particolare tipo di hook, il sistema operativo inizia 
ad invocare le hook procedure della catena, ed all'in- 
terno di essa si determina se l'evento debba essere 
passato alla procedura successiva. In caso afferma- 
tivo, l'evento viene propagato per mezzo della fun- 
zione CallNextHookEx,. Per alcuni tipi di hook è pos- 
sibile solo monitorare gli eventi, in questi casi sarà il 
sistema operativo ad invocare la funzione CallNext- 
HookEx, anche se all'interno della procedura non 
viene fatto esplicitamente. Ogni tipo di hook con- 
sente di monitorare un differente aspetto del siste- 
ma a messaggi di Windows. 



UNA CLASSE .NET 
PER GLI HOOK 

Il framework .NET non fornisce alcuna funzionalità 
interna per la gestione degli hook, e dunque è ne- 
cessario ricorrere ai meccanismi di Platform Invoke, 
che consentono di utilizzare all'interno del codice 
managed le funzioni native del sistema operativo o 
comunque implementate in codice non gestito. 
Mediante Pllnvoke è dunque possibile continuare 
ad utilizzare le funzioni sopra introdotte, importan- 
dole all'interno del nostro codice gestito, come fare- 
mo ad esempio in C#. Le funzioni SetWindowsHook- 
Ex, UnhookWindowsHookEx e CallNextHookEx so- 
no contenute all'interno della libreria di Windows 
user32.dll. Per poterle utilizzare in C# dobbiamo in- 
nanzitutto dichiararle nella maniera seguente: 

[DIIImportCuser32.dll")] 

public static extern IntPtr SetWindowsHookEx( 

HookType code, CbtHook.CbtProc fune, 
IntPtr hlnstance,int threadID); 

[DIIImport("user32.dll")] 

public static extern int UnhookWindowsHookEx( 

IntPtr hhook); 

[DIIImport("user32.dll")] 

public static extern int CallNextHookEx(IntPtr hHook, 
int nCode, Int32 wParam, IntPtr IParam); 

L'uso dell'attributo Dlllmport, come potete notare, è 
in questo caso abbastanza semplice, basta indicare 
il nome della dll contenente la funzione che si vuole 
importare precedendo la dichiarazione stessa. Di- 
chiarazione che avverrà con i modificatori static 



extern, ed in questo caso public. La dichiarazione 
del metodo deve naturalmente rispettare la firma 
della corrispondente funzione da importare, tradu- 
cendo il tipo di ritorno e quelli dei parametri even- 
tuali. Ad esempio la SetWindowsHookEx, restituisce 
un handle HHOOK, che in .NET è stato tradotto con 
il tipo IntPtr. IntPtr è infatti un tipo struct che rap- 
presenta un puntatore o un handle. 
Anche il parametro hlnstance verrà dunque impor- 
tato come un IntPtr. Il primo e l'ultimo parametro 
invece sono degli interi, e quindi è sufficiente utiliz- 
zare il tipo int di C#, anche se spesso, quando i valo- 
ri ammissibili sono ben determinati, è possibile 
implementare dei dpi enumerativi in maniera da 
passare come argomento solo i valori corretti. Il 
primo parametro rappresenta infatti il tipo di hook 
che si desidera installare, ed esso può assumere uno 
dei valori che è possibile trovare nell'header file 
WinUser.h del Microsoft SDK. Con tali valori creere- 
mo il tipo enumerativo HookCode, nel seguente 
modo: 



public 


enum HookCode 




{ 


WH_ 


JOURNALRECORD = 


0, 


WH. 


JOURNALPLAYBACK 


= 1, 


WH. 


_KEYBOARD = 2, 




WH_ 


J3ETMESSAGE = 3, 




WH_ 


_CALLWNDPROC = 4, 




WH_ 


_CBT = 5, 




WH. 


_SYSMSGFILTER = 6, 




WH_ 


_MOUSE = 7, 




WH_ 


HARDWARE = 8, 




WH. 


_DEBUG = 9, 




WH_ 


_SHELL = 10, 




WH_ 


_FOREGROUNDIDLE = 


= 11, 


WH. 


_CALLWNDPROCRET = 


= 12, 


WH_ 


_KEYBOARD_LL =13 




WH_ 


_MOUSEJ_L = 14 




} 



Con l'utilizzo di un tipo enumerativo, il codice divie- 
ne molto più semplice sia da scrivere, sia da leggere 
e mantenere. Ad esempio se vogliamo installare un 
hook per gli eventi relativi alla shell di Windows 
dovremo passare come argomento il valore 10, o 
corrispondentemente, in maniera più comoda il va- 
lore HookCode.WH_SHELL. 

Nel nostro esempio gestiremo invece gli eventi di 
mouse e tastiera, in maniera da avere un log delle 
attività dell'utente sulle due periferiche, dunque uti- 
lizzeremo i valori 13 e 14. 

Il secondo parametro della funzione è di tipo 
HOOKPROC, che rappresenta un puntatore ad una 
funzione di callback, che dovrà rispettare, come vi- 
sto, la seguente firma: 





I TUOI APPUNTI 



Utilizza questo spazio per 
le tue annotazioni 



IL PROGETTO 

Sul CD o sul sito web di 
loProgrammo trovate il 
codice completo dell'ap- 
plicazione. Esso è costi- 
tuito da una soluzione 
per Visual Studio 2003, 
ma naturalmente è pos- 
sibile compilare da riga 
di comando per mezzo 
del compilatore c# (o 
lanciando il file compi- 
la. bat): 



esc louthooks.exe 
Hook.cs 

KeyboardHook. cs 
MouseHook.cs Form1.cs 



LRESULT CALLBACK HookProc( 
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GLOSSARIO 



I DELEGATE 

I delegate di .NET con- 
sentono di incapsulare 
all'interno di un ogget- 
to un riferimento ad 
un metodo, in maniera 
analoga al meccanismo 
dei puntatori a funzio- 
ne caro agli sviluppato- 
ri C e C++. L'oggetto 
delegate potrà quindi 
essere usato per invo- 
care il metodo in esso 
incapsulato. 
A differenza dei 
puntatori a funzione i 
delegate sono type- 
safe, object oriented e 
sicuri. 



int code, WPARAM w, LPARAM I) 

Corrispondentemente, in .NET, bisognerà imple- 
mentare un delegate con la stessa firma della fun- 
zione di callback, traducendo in maniera opportuna 
i tipi dei parametri. In questo caso creeremo un de- 
legate così: 

public delegate int HookProc(int code, IntPtr wParam, 

IntPtr IParam); 

Per chi non fosse a conoscenza del concetto di dele- 
gate, nel box laterale viene fornita una breve spiega- 
zione. 



LA CLASSE HOOK 

È ora adesso di creare una classe in C#, in maniera 
da poter utilizzare le funzionalità fin qui esposte in 
maniera perfettamente object oriented, e traducen- 
do il tutto sfruttando i concetti .NET di eventi e dele- 
gate. La classe che scriveremo sarà una classe astrat- 
ta, in maniera da non poterne creare istanze, ma per 
poterla estendere in maniera semplice con classi 
che gestiscano ognuna un tipo di hook. Chiamiamo 
dunque questa classe base Hook, e dotiamola di un 
campo mjiCode di tipo HookCode, il cui scopo sarà 
quello di memorizzare il tipo di hook rappresentato 
da una istanza della classe, mentre il campo 
mJiHook conterrà l'handle alla procedura di hook 
una volta installata, o il valore se l'installazione 
non va a buon fine. 

Tale valore è esattamente quello restituito dalla fun- 
zione SetWindowsHookEx. 
La classe Hook avrà dunque questa struttura: 

public abstract class Hook 
{ 

[DIIImport("user32.dll")] 

public static extern int SetWindowsHookEx( 

HookCode hCode, HookProc Ipfn, 
IntPtr hlnstance, int threadld); 
[DIIImport("user32.dll")] 
public static extern bool UnhookWindowsHookEx( 

int hHook); 
[DIIImport("user32.dll")] 

public static extern int CallNextHookEx(int hHook, 
int nCode, IntPtr wParam, IntPtr IParam); 
public delegate int HookProc( 

int nCode, IntPtr wParam, IntPtr IParam); 
protected int m_hHook; 
protected HookCode m_nCode; 
protected HookProc HookDelegate; 



L'unico argomento del costruttore è un parametro 
del tipo enumerativo HookCode che identifica il tipo 
di hook da gestire: 



public Hook(HookCode he) 



{ 



m_code=hc; 



} 



Implementiamo inoltre i due metodi Instali ed 
Uninstall, che permettono di installare e disinstalla- 
re la procedura di hook rappresentata dal delegate 
HookProc. Essi non fanno altro che richiamare le 
funzioni per gli hook importate tramite PInvoke. 

public void Installo 

{ m_hHook=SetWindowsHookEx( 

m_code, HookDelegate, Marshal.GetHINSTANCE( 

Assembly.GetExecutingAssembly() 

.GetModules()[0]), 0); } 



public void Uninstall() 




{ if(m_hHook! 


= 0) 








{ bool bRet= 


= UnhookW 


ndowsHookEx( 
m_ 


_hHook); 




m_hHook= 


= 0; 






if(!bRet) 




throw new Exception("Impossibile 
disinstallare 


l'hook"); 


} 


} 


} 



La classe Hook così implementata costituisce una 
base astratta per delle classi che gestiscano dei par- 
ticolari tipi di evento. Non ci resta adesso che imple- 
mentare le classi che gestiscano particolari tipi di 
hook, cioè quelli che ci interessano, e che saranno 
concrete e istanziabili in una nostra applicazione. 



HOOK PER MOUSE 
E TASTIERA 

Supponiamo di voler monitorare gli eventi di mouse 
e tastiera, quello che dobbiamo fare è estendere la 
classe Hook in maniera opportuna, sfruttando i 
metodi generali in essa definiti, e creando ad esem- 
pio una gerarchia come quella in Figura 1. 
Cominciamo con l'implementare una classe Mouse- 
Hook, nel cui costruttore viene direttamente impo- 
stato il tipo HookCode.WH_MOUSE_LL ed inoltre 
impostiamo anche il delegate che costituisce la hook 
procedure da invocare quando si verifica un evento 
relativo al mouse. 



public 


MouseHook():base(HookCode.WH_ 


_MOUSE_ 


J-L) 


{ 


this 


HookDelegate= 


= new HookProc(MouseHookP 


•oc); 


} 



Inoltre specifichiamo un evento, cioè un delegate da 
invocare all'interno della hook procedure e che verrà 
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consumato da un eventuale gestore interessato 
all'evento stesso: 

public event MouseEventHandler OnMouseActivity; 

Il metodo MouseHookProc dovrà invece rispettare la 
firma del delegate HookProc. Al suo interno gestire- 
mo il messaggio di Windows, ricavandone i parame- 
tri, con i quali costruiremo un oggetto MouseEvent- 
Args da passare al delegate OnMouseActivity, cioè a 
tutti gli eventuali gestori dell'evento stesso. 
Il parametro wParam indica tipo di evento, in que- 
sto caso l'unico evento gestito è il movimento del 
mouse, WM_MOUSEMOVE. Ulteriori informazioni, 
ad esempio le coordinate del puntatore del mouse 
sono ricavate dal parametro IParam con cui viene 
riempita una struttura MOUSEHOOKSTRUCT, 



public ìnt flags; 



public ìnt time; 



struct MOUSEHOOKSTRUCT 


{ 


public 


Point pt; 


public 


IntPtr hwnd; 


public 


uint wHitTestCode; 


public 


IntPtr dwExtralnfo; 


} 



Una volta riempiti i campi della struttura, da essa 
poi costruiamo un oggetto MouseEventArgs da pas- 
sare al delegate OnMouseActivity: 



public IntPtr dwExtralnfo; 



} 



Mentre la procedura di gestione sarà implementata 
in questa maniera: 

private int KeyboardHookProc(int nCode, IntPtr 

wParam, IntPtr IParam) 

{ if(nCode>=0) 

{ KBDLLHOOKSTRUCT mhs = (KBDLLHOOKSTRUCT) 
Marshal.PtrToStructure(IParam,typeof( 
KBDLLHOOKSTRUCT)); 
KeyEventArgsEx e=new KeyEventArgsEx((Keys)mhs 
.vkCode, wParam. ToInt32()); 
OnKeyboardActivity(this, e); } 
Hook. Cali NextHookEx(m_hHook,nCode, wParam, 

IParam); 
return 0; 
} 



In questo caso il parametro wParam indica il tipo di 
evento sui tasti, cioè se si tratta di una pressione o 
del rilascio del tasto. Invece IParam indica il codice 
del tasto premuto. La classe standard KEyEventArgs 
però consente di impostare solo il secondo. Dunque 
estendiamo quest'ultima aggiungendo al costrutto- 
re anche il tipo di evento che si è verificato: 





GLOSSARIO 



P/IMVOKE 

Platform Invoke o 
Plnvoke è il 
meccanismo che 
permette al codice 
gestito di .NET di 
individuare le funzioni 
esportate da una DLL 
nativa, caricarle in 
memoria, ed invocarle 
effettuando una sorta 
di traduzione dei suoi 
argomenti. 



private int MouseHookProc(int nCode, IntPtr wParam, 

IntPtr IParam) 
{ if(nCode> = 0) 

{ if(wParam.ToInt32() ==WM_MOUSEMOVE) 
{ MOUSEHOOKSTRUCT mhs = 
(MOUSEHOOKSTRUCT) Marshal.PtrToStructure( 
IParam, typeof(MOUSEHOOKSTRUCT)); 
MouseEventArgs e=new MouseEventArgs( 

(MouseButtons)nCode, 0, mhs.pt.X, 
mhs.pt.Y, ); 



OnMouseActivity(this, e); } 



} 



return Hook.CallNextHookEx( 

m_hHook,nCode, wParam, IParam); 



} 



Notate che come ultima istruzione viene invocato il 
metodo CallNextHookEx ereditato dalla classe base 
Hook. In maniera perfettamente analoga imple- 
mentiamo una classe KeyboardHook, per monitora- 
re la pressione dei tasti ed effettuare ad esempio una 
sorta di log dell'attività della tastiera. Questa volta 
abbiamo bisogno di una struttura KBDLLHOOK- 
STRUCT siffatta: 

struct KBDLLHOOKSTRUCT 
{ public int vkCode; 
public int scanCode; 



public class KeyEventArgsEx :KeyEventArgs 
{ public enum KeyMessage 
{ KeyDown=256, 



KeyUp=257 } 



public KeyMessage Message; 



: HookCode 
egate: HookPrc 



:: :. : i 



: : : : : :: 

CallNe*tHookE*fint, int, IntPtr, IntPtr) : 

HookProc<int, IntPtr, IntPtr) : int 

HooKHookCode) 

Installo : ™id 

UninstallQ : void 





«enumeration» 
Hook Code 


+ WH KEYBOARD: int -2 




+ WH_GETMESSAGE: int- 3 
+ WH CALLWNDPROC: int- 4 




#m code 


+ WH CBT: int = 5 




+ WH SYSMSGFILTER: int=6 




+ WH MOUSE: int = 7 




+ WH HARDWARE: int = 8 




+ WH DEBUG: int = 9 




+ WH SHELL: int= 10 








+ WH CALLWNDPROCRET: int= 12 




+ WH KEYBOARD LL: int =13 




+ WH_MOUSE_LL: int= 14 



Mouse Hook 



WM_MOUSEMOVE: int= 0x200 
WM_LBUTTONDOWN: int = 0x201 
WM_LBUTTONUP: int = 0x202 
WM_LBUTTONDBLCLK: int = 0x203 
WM_RBUTTONDOWN: int = 0x204 
WM_RBUTTONUP: int = 0x205 
WM_RBUTTONDBLCLK: int = 0x206 
WM_MBUTTONDOWN: int = 0x207 
WM_MBUTTONUP: int = 0x208 
WM_MBUTTOHDBLCLK: int = 0x209 
«event» OnMouseActivity: MouseEventHandler 



rfouseHookO 

lylouseHookProcOnt. IntPtr. IntPtr) : int 



KeyboarciHov^ 



«event» On! ity: KeyEventHandler 



KeyboardHoolO 

KeyboardHookProcrjrit. IntPtr. IntPtr) : int 



«struct» 
MOUSEHOOKSTRUCT 



pt Point 

htnjnd: IntPtr 

uvHitTestCode: uin 

jilnfo: IntPtr 



«struct» 
KBDLLHOOKSTRUCT 



vkCode: int 
scanCode: int 
flags: int 
time: int 

.a Info: IntPtr 



Fig. 1: La gerarchia derivata dalia classe Hook 
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public KeyEventArgsEx(Keys vkCode,int msg) 

:base(vkCode) 
{ this.Message=(KeyMessage)msg;} 



uni ESEMPIO 
APPLICATIVO 

Con le classi MouseHook e KeyboardHook possiamo 
creare un'applicazione Windows Forms, per moni- 
torare i due relativi tipi di eventi. Ad esempio pos- 
siamo contare la distanza percorsa dal mouse, come 
una specie di contachilometri, anzi contapixels, 
mentre con la seconda classe creeremo un log dei 
tasti premuti. Implementiamo dunque una Form 
con una label che mostri la distanza percorsa dal 
mouse ed una casella di testo in cui invece scrivere- 
mo il codice di ogni tasto premuto durante la vita 
dell'applicazione stessa. Prima di tutto però è ne- 
cessario creare le istanze delle due classi Hook ed 
invocare il metodo Instali per ognuna delle due: 

mh = new MouseHook(); 

mh.OnMouseActivity+ = new MouseEventHandler( 

mh_OnMouseActivity); 
mh. Installo; 

kh = new KeyboardHook(); 
kh.OnKeyboardActivity+ = new KeyEventHandler( 

kh_OnKey board Activity); 
kh. Installo; 

Gli eventi relativi verranno gestiti tramite i due me- 
todi inhjOnMouseActivlty e khjOnKeyboardActivi- 
ty, che rispondono alla firma dei delegate rispettivi. 
Nel primo viene calcolata la distanza fra la posizio- 
ne attuale del puntatore del mouse e quella memo- 
rizzata all'ultimo verificarsi dell'evento. Il risultato 
verrà memorizzato nel campo totPixels e mostrato 
come testo della label labPixels: 

private void mh_OnMouseActivity(object sender, 

MouseEventArgs e) 
{ Point ptl\lew=new Point(e.X,e.Y); 
totPixels+=CalcDist(ptPrec,ptNew); 
ptPrec=new Point(e.X,e.Y); 
this.labPixels.Text=String. Format("{0 :D14}", 

totPixels); 



Il metodo utilizza la seguente procedura che calco- 
la la distanza fra due punti, i più ferrati in matema- 
tica non hanno bisogno in questo caso di alcuna 
spiegazione aggiuntiva: 

private int CalcDist(Point pi, Point p2) 
{ int dist=(int)Math.Sqrt(Math.Pow((p2.X-pl.X),2) 
+ Math.Pow((p2.Y-pl.Y),2)); 



return dist; 



} 



Il metodo seguente invece ricava il codice del tasto 
premuto ed il tipo di evento, aggiungendo una nuo- 
va linea alla casella rtfBox: 

private void kh_OnKeyboardActivity(object sender, 

KeyEventArgs e) 
{ KeyEventArgsEx ex=(KeyEventArgsEx)e; 
this.rtfBox.AppendText(Environment.NewLine 

+ex.Message.ToString()+" key:"+ex.KeyCode); 
} 

Alla chiusura della applicazione, se i due hook sono 
stati installati, essi verranno rimossi semplicemente 
invocando il metodo Uninstall 



if(mh 


=null) 


mh.UninstallO; 


if(kh! 


=null) 


kh.Uninstall(); 



In questa maniera abbiamo terminato la nostra 
semplice applicazione di esempio, la cui unica form 
è mostrata nella figura seguente: 



Stop | 



Il mouse ha QGGGGGG0G3546G Pixels 
percorso 



iveyup K.ey:A 
KeyDown key:C 
KeyDown key:D 
KeyUp key:C 
Key pkey:D 

KeyD ìwn key:LControlKey 
KeyDown key:J 
KeyUp key:J 
KeyDown key:N 
KeyDown key:K 
KeyUp key:N 
KeyDown key:M 
KeyUp key:K 
iv-y P key:M 
KeyUp key:LControlKey 
Key pkeyJ ìhiftkey 



A 



Fig. 2: L'applicazione per monitorare mouse e tastiera 



CONCLUSIONI 

Sebbene l'applicazione realizzata non abbia una 
vera e propria utilità pratica, essa costituisce un 
buon esempio di partenza per l'utilizzo degli hook 
di Windows, e soprattutto, l'articolo ha mostrato 
come gestire concetti un po' più avanzati all'interno 
di un'applicazione gestita, facendo uso della tecno- 
logia Platform Invoke. Naturalmente l'argomento è 
molto vasto e complesso per essere esaurito in un 
solo articolo, ma il nostro scopo era quello di forni- 
re un'introduzione e di stuzzicare il vostro appetito 
di conoscenze. 

Antonio Pelleriti 
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Conoscere le Black List 



Una lista nera 
per gli spammer 

Le Black List un metodo utilizzato a livello mondiale per combattere 
lo spam. Importante da conoscere se si gestisce un mail server, 
o semplicemente per saperne di più su che fine fa la nostra posta 





Tempo di realizzazione 



In questo articolo analizzeremo il funzionamen- 
to delle "Black List", un metodo utilizzato soven- 
te lato server e invisibile all'utente finale, la cui 
conoscenza è però importantissima per chi gestisce 
un "mail server" o per chi ricevendo molta posta 
spazzatura desidera fare in modo che allo spammer 
venga negato l'utilizzo della rete per fini non legitti- 
mi. Dalle nostre parole avrete già capito che il meto- 
do in questione non coinvolge il proprio computer e 
le proprie risorse personali, si riferisce invece a un 
metodo più generale che tende a combattere ad un 
livello più ampio lo spam. L'idea è molto semplice. 
Alcuni siti web raccolgono le segnalazioni degli 
utenti in relazione a "denunce" di spam. I server 
SMTP dei vari provider quando ricevono una mail 
interrogano questi siti web e, se mittente del mes- 
saggio non è elencato nelle liste degli spammer, allo- 
ra viene regolarmente inviato all'utente, viceversa 
viene bloccato. In sostanza, un utente non riceverà 
mai i messaggi di spam perché questi messaggi ver- 
ranno filtrati a livello di server e non a livello utente. 
Allo stato attuale tutti i grandi provider come anche 
i piccoli, utilizzano questo metodo per combattere 
lo spam. Da Interbusiness, aWind aTiscali, ognuno 
utilizza in un modo o nell'altro servizi di Black List 
internazionali. 



SEI SULLA LISTA MERA! 

Perché una black list abbia effetto, è necessario che 
l'elenco dei mittenti sia il più possibile completo. 
Per ottenere un elenco completo ed esaustivo è 
imprescindibile una organizzazione a livello mon- 
diale. Non ha senso infatti creare la propria lista 
personale sul proprio PC o in una rete locale. Per 
questo motivo sono nate molte organizzazioni che 
gestiscono un elenco globale di mittenti indeside- 
rati. Nella maggioranza di questi non viene memo- 
rizzato il mittente, ad esempio max2005@libero.it, 



ma l'indirizzo IP del server che invia il messaggio. Il 
protocollo di posta di Internet (SMTP) funziona 
infatti attraverso la connessione diretta tra i diversi 
server. 

Quando si invia un messaggio di posta, lo si tra- 
smette tramite un server SMTP Ad esempio, questo 
può essere mail.libero.it. Il server a cui corrisponde 
questo nome di dominio riceve il messaggio e lo 
manda al server di destinazione. Se ad esempio il 
messaggio è destinato a lele2005@tiscalinet.it, il 
server mail.libero.it cerca di connettersi al server di 
tiscali. L'indirizzo preciso del server viene restituito 
in un record "MX" attraverso una ricerca su DNS. 
Se il server mail.libero.it è inserito in black list ed il 
server di posta di tiscalinet.it supporta la gestione 
della black list, il messaggio viene rifiutato. Questo 
avviene perché il server che invia è presente nelle 
black list. Ovviamente alcune volte succede che i 
mittenti siano inseriti in black list erroneamente. 
L'utilizzo di una black list ha diversi vantaggi. Ad 
esempio i maggiori server di posta supportano 
questa feature in modo nativo. In questo modo l'in- 
troduzione di questo ulteriore elemento di sicurez- 
za avviene semplicemente configurando il server. 
Inoltre la protezione è subito attiva, grazie al data- 
base presente nei siti che forniscono il servizio. 
Detto questo, è bene notare anche che è anche pos- 
sibile comunicare ai fornitori della black list even- 
tuali nuovi mittenti indesiderati, in modo che ven- 
gano inseriti nei database. 



OPEN RELAY 

Ci sono diverse cause per cui un mail server può 
finire in una black list. Il motivo principe per cui un 
sever può finire in Black List è quello di essere un 
"Open relay". La definizione di Open Relay è piutto- 
sto ampia. In linea del tutto generale è un Open 
Relay un server che consente ad utenti anonimi di 
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inviare la posta. Ad esempio, se il provider pippoe- 
pluto.it fornisse il servizio di posta e un qualunque 
utente riuscisse a inviare la posta tramite questo 
provider senza autenticarsi, questo sarebbe un 
Open Relay. 

Chiaramente se un utente può fare spam senza po- 
ter essere identificato è potenzialmente pericoloso. 
Viceversa si pensa che gli utenti autenticati siano 
fidati e che non facciano spam. L'autenticazione al 
server SMTP avviene quando l'utente fornisce una 
username e una password per inviare la posta. 
Attenzione a non confondere password e utente 
per l'invio con quello per la ricezione. Il protocol- 
lo che consente di inviare la posta è l'SMTP quel- 
lo che consente di ricevere il P0P3. Quando un 
server SMTP invia la posta, un altro server SMTP 
la riceve e la smista (dispatch) a un server P0P3. 
L'utente destinatario si connette al server POP3 e 
"scarica" la posta tramite username e password. 
Un'altra protezione contro il relay è tipicamente 
quella di limitare l'invio della posta ai soli utenti 
che utilizzano un indirizzo IP sulla stessa rete su 
cui è posizionato il server SMTP Avete mai prova- 
to a usare ad esempio il server di tiscali per invia- 
re le email mentre siete collegati tramite un provi- 
der differente, ad esempio Telecom? Dubito che ci 
riuscirete. 



INSIDIE 

DELLE BLACK LIST 

Supponete di aver preso un bel virus. Supponete che 
questo virus non faccia altro che nascondere al suo 



interno un Mail Server. Uno spammer potrebbe 
usarvi come ponte per inviare la posta. Risultato: il 
vostro indirizzo IP potrebbe essere segnalato a una 
Black List; risultato secondario: l'intero provider 
proprietario di quell'indirizzo IP potrebbe essere 
"bannato" dalla rete internet. Attenzione, non è 
un'eventualità improbabile, ai provider di grosse di- 
mensioni capita spesso e volentieri. Questi troiani 
sono utilizzati dai malintenzionati per inviare posta 
in modo anonimo, con un frequente cambio di IP 
del mittente. Proprio per evitare di essere intercetta- 
ti da liste di blocco. Nella maggior parte dei casi è 
possibile essere rimossi dalle liste di blocco. Tipica- 
mente è sufficiente segnalare alla Black List di avere 
rimosso la causa per cui si era stati inseriti in BL. Per 
fare questo è necessario contattare gli amministra- 
tori della lista in oggetto utilizzando le procedure da 
loro fornite. I gestori della BL controlleranno che la 
causa sia stata effettivamente rimossa, ad esempio 
proveranno a usarvi come Open Relay, e se verifica- 
no che ogni cosa è tornata al suo posto, vi elimine- 
ranno dalle Black List. 



COME INTERROGARE 
LE BLACK LIST 

Si noti che le liste di blocco non possono essere sca- 
ricate integralmente, perché si compongono di 
megabyte di informazioni. Alcuni fornitori di servi- 
zio prima lo prevedevano, ma sono stati costretti 
a limitare questa possibilità. L'accesso alle liste 
avviene invece per interrogazione. L'utente o il 
sistema digitano l'indirizzo IP sospetto ed il 




RECORD MX 

Un record MX è un tipo 
di informazione 
contenuto nel sistema 
di nomi dei domini 
(DNS) che indica come 
deve essere 
reindirizzata la posta 
Internet. Quando un 
messaggio viene 
inviato ad un server di 
posta, questo esegue 
una query DNS 
richiedendo il record 
MX del destinatario. 



ALCUNI PROVIDER DI BLACK LIST 



Su Internet sono disponibili 
diversi siti che forniscono im- 
plementazioni di black list. Al- 
cuni di questi siti collaborano 
tra di loro mettendo in co- 
mune le proprie basi dati. Or- 
ganizzazioni degne di nota in 
merito alla gestione di liste di 
blocco sono: 

Spamhaus - SBL è un databa- 
se in tempo reale di indirizzi 
IP di mittenti verificati di po- 
sta spazzatura. Per "mittenti" 
si intendono spammers, grup- 
pi di spam e servizi di suppor- 
to agli spammer. È mantenu- 
to dal gruppo di supporto del 
progetto Spamhaus. È fornito 
gratuitamente per aiutare gli 
amministratori della posta a 
gestire meglio i flussi di in- 
put. SBL è richiamabile in 



tempo reale dai sistemi di 
mail presenti in Internet. SBL 
permette agli amministratori 
di identificare e bloccare con- 
nessioni da indirizzi IP coin- 
volti nell'invio di posta non 
richiesta. Il database è aggior- 
nato ogni ora nell'arco della 
settimana da un gruppo di 
supporto composto da statu- 
nitensi, inglesi, olandesi, ita- 
liani, giapponesi e serve di- 
versi Paesi in tutto il mondo. 

Abusive Hosts Blocking 
List (AHBL) - Questa orga- 
nizzazione è gestita da una di- 
visione del Summit Open 
Source Development Group 
(SOSDG), un'azienda di svilup- 
po di tecnologie open source. 
Si basa su informazioni otte- 
nute da varie sorgenti su In- 



ternet e su strumenti di trac- 
ciatura e database proprieta- 
ri. Anche AHBL fornisce un da- 
tabase di indirizzi di macchine 
coinvolte con la posta spazza- 
tura. Il servizio più rilevante, 
tra i tanti offerti da AHBL, è il 
DNSbl ìp4r. Questo consente 
la ricerca di host che inviano 
posta abusiva, o che contiene 
virus, oppure tentativi di phi- 
sing. 

Spamcop - Questa azienda 
mantiene la SpamCop Block- 
ing List (SCBL), una lista di in- 
dirizzi utilizzati per inviare 
posta indesiderata agli utenti 
SpamCop. Il database può 
quindi essere utilizzato da 
fornitori di servizi ed utenti 
individuali per bloccare e fil- 
trare posta spazzatura. 



DSBL - Il gruppo Distribuiteci 
Sender Blackhole List si occu- 
pa di raccogliere indirizzi IP di 
computer che hanno inviato 
speciali mail di test alla stessa 
DSBL. In pratica, DSBL attende 
un messaggio sulla casella 
listme@listme.dsbl.org. quando 
questo arriva, l'indirizzo IP 
del mittente viene inserito in 
elenco. Infatti, un utente nor- 
male non ha motivo per invia- 
re messaggi a quella partico- 
lare casella. Ma gli spammer 
che raccolgono in modo auto- 
matico indirizzi di posta dalle 
pagine Web non lo sanno. 
Dunque raccolgono anche 
questo indirizzo e cominciano 
ad inviare messaggi indeside- 
rati. E questo li inserisce 
nell'elenco degli spammer ge- 
stito da DSBL. 
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QUERY MX 

Il record MX contiene 

un elenco di host che 

accettano posta per 

quel dominio. Per 

ciascun host viene 

restituita anche la 

distanza. Il server di 

invio quindi sceglie il 

server più vicino e 

cerca di stabilire una 

connessione per 

l'invio del messaggio. 



sistema dice se è presente nel suo database. 
Ovviamente questi fornitori di servizio devono 
essere sostenuti da hardware molto potente e 
banda a volontà. Si pensi a tutte le interrogazioni 
che possono ricevere. Per averne una idea biso- 
gna moltiplicare il numero di server di posta pre- 
senti in Internet per il numero di messaggi gesti- 
ti al giorno. Il risultato è sicuramente un numero 
considerevole. 



SPAMMER E BLACK LIST 

I malintenzionati utilizzano diverse tecniche per 
aggirare le liste di blocco e le normative contro la 
posta indesiderata. Ad esempio creano un falso 
ISP (Internet Service Provider) con il quale acqui- 
stano dai grandi provider, banda e connessioni di 
rete. Giustificando la richiesta, con il fatto che il 
falso ISP ha clienti a sua volta che si connettono 
in dial-up. Lo spammer in realtà poi utilizza que- 
sta connessione di rete non per fantomatici clien- 
ti, ma per inviare i propri messaggi spazzatura. 
Quando qualcuno si lamenta con il grande provi- 
der dello spam inviato con le sue connessioni, 
questo inoltra le lamentele all'ISP fantoccio. 
Queste lamentele dovrebbero essere dirette agli 
ipotetici utenti. Ma essendo tutto un imbroglio, 
ovviamente le lamentele cadono nel vuoto. 
Inoltre, grazie al fatto che gli spammer acquistano 
grandi quantità di banda, spesso i grandi ISP sono 
disposti a chiudere un occhio. Alcune volte la 
connettività è acquistata "off-shore", ad esempio 
in Cina. Questo viene fatto per evitare le autorità 
dove vigono leggi severe, come negli Stati Uniti. 



Ma spesso anche gli host off-shore sono presto 
bloccati e terminati. Per questo lo spammer deve 
cambiare spesso provider, saltando da uno all'al- 
tro. Un trucco utilizzato spesso è quello di utiliz- 
zare lo stesso computer per ospitare siti di sup- 
porto per le truffe via Internet e per inviare la 
posta spazzatura. Viene poi utilizzato un server 
DNS che si aggiorna automaticamente per punta- 
re ad un nuovo indirizzo IP quando cade la linea 
in dial-up oppure il provider taglia il collegamen- 
to. Questi sistemi sono supportati da una copia di 
backup sempre pronta. Quando le autorità taglia- 
no il collegamento ad un computer, ne è già pron- 
to un altro per sostituirlo. Secondo Spamhaus, 
l'80% della posta spazzatura è generata da solo 
200 organizzazioni, per di più note. Queste orga- 
nizzazioni utilizzano circa 500-600 persone, che 
cambiano continuamente alias e domini. Queste 
organizzazioni sono elencate nel ROSKO (Register 
of Known Spam Operations) e operano illegal- 
mente. Per essere inseriti nel ROSKO, uno spam- 
mer deve essere stato oggetto di annullamento 
del contratto da almeno 3 fornitori di servizio, per 
violazioni relative alla posta spazzatura. Le sotto- 
reti e gli indirizzi IP sotto il controllo dei soggetti 
elencati nel ROSKO sono inseriti automaticamen- 
te in alcune liste di blocco, come SBL. 



UHI OCCHIO AL CODICE 

Per capire come può essere possibile eseguire una 
interrogazione viene preso in esame un server di 
posta specifico, James. Questo server scritto in Java è 
un server di posta SMTPT e POP3. Include anche il 



CONFIGURARE MAILENABLE CONTRO LO SPAM 



Mailenable è un server di mail 
disponibile in versione Free 
all'indirizzo 





LE PROPRIETÀ SMTP 
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Q Dall'interfaccia di gestione di 
Mailenable cliccare su connectors, 
poi su SMTP e con il tasto destro su 
Proprietà 



http://www.mailenable.com . La 
versione Free contiene tutte le 
caratteristiche della versione 

GESTIRE IL RELAY 




Selezionare la tabsheet Relay e 

settare i parametri per 
l'autenticazione SMTP. L'autenticazione 
integrata è una buona scelta 



professional, eccetto alcuni servizi 
come ad esempio l'interfaccia di 
configurazione via web. 

SETTARE LE BLACK LIST 



e a 



Selezionare la tabsheet "Reverse 
Dns Blacklisting" ed abilitare la BL 

tramite l'apposito Flag. Abilitare poi le 

singole black list da utilizzare 
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supporto al protocollo per le news NNTR II suo 
nome completo è Apache Java Enterprise Mail Ser- 
ver {http:lliames.apache.org/] ed è sviluppato dal- 
\' Apache Foundation. Inoltre, James è una piattafor- 
ma per la gestione della posta elettronica. Il gruppo 
di sviluppo ha infatti realizzato delle API per scrive- 
re codice Java che elabora i messaggi di posta elet- 
tronica. Nel fare questo è stato creato il termine mai- 
let, sulla falsariga dei nomi Applet, Servlet e MIDlet. 
Le mailet possono essere utilizzate ad esempio per 
generare risposte automatiche, oppure aggiornare 
un database, evitare la posta indesiderata, archivia- 
re i messaggi o altre cose ancora. Per capire se un 
mailet deve elaborare uno specifico messaggio in- 
terviene un altro componente, il matcher. Le API di 
mailet e matcher sono sviluppate come parte del 
progetto James, mentre il server vero e proprio ne 
fornisce una implementazione di riferimento. 
È importante notare come James, mailet e matcher 
non sono API standard di SUN. JavaMail, diversa- 
mente, è uno standard ufficiale. Ma il suo scopo è 
leggere le mail dal server. È dunque una tecnologia 
client e non server. Al momento della stesura di que- 
sto articolo l'ultima versione di James stabile dispo- 
nibile è la 2.2.0. Guarderemo quindi nei suoi sorgen- 
ti per capire come è stato implementato il controllo 
tramite black list in James. 

La classe che ci interessa è org .apache.james.tran- 
sport.matchers.InSpammerBlacklist, che è una sot- 
toclasse di GenericMatcher. L'intercettazione dei 
messaggi avviene quindi attraverso un matcher. Il 
metodo più importante in queste componenti è 
matchO- Se il metodo torna nuli l'elaborazione pro- 
segue, altrimenti vengono ritornati i destinatari del 
messaggio. Il parametro di tipo Mail identifica inve- 
ce il messaggio da controllare. Nel listato seguente è 
presente l'implementazione del metodo matchO 
presente nella classe InSpammerBlacklist del server 
di posta James. I passi eseguiti dal codice sono i 
seguenti: 

1 l'indirizzo del server di invio, ottenuto con il me- 
todo getRemoteAddrO viene rovesciato. Se ad 
esempio è 220.186.10.20 viene convertito in 
20.10.186.220. questa operazione viene svolta 
attraverso un oggetto StringTokenizer che separa 
gli ottetti cercando il punto (.) separatore; 

2 all'indirizzo ottenuto viene aggiunto il nome del 
prefisso per la lista di blocco in uso, p.e. shl.spa- 
mhaus.org. nel caso dell'esempio precedente si 
avrebbe20.10.186.220.sbl.spamhaus.org, 

3 attraverso la classe DNSServer viene verificata 
l'esistenza nei DNS dell'indirizzo cercato. La ri- 
cerca avviene tramite il metodo getByNameO- La 
classe DNSServer è implementata in una libreria 
Java di accesso a DNS presente sul sito 
www.xbill.org; 

4 se viene sollevata una UnknownHostException 



significa che l'indirizzo non esiste, dunque il 
mittente è sicuro ed il metodo può ritornare nuli; 
5 se non si sollevano eccezioni, vengono restituiti 
tutti i destinatari del messaggio, ottenuti con la 
chiamata al metodo getRecipientsf) sull'oggetto 
Mail passato come parametro al metodo. 
Questo comunica a James che il messaggio è 
stato eliminato dal matcher di controllo della 
lista di blocco. 

public Collection match(Mail mail) { 
String host = mail. getRemoteAddrO; 

try { 

//le liste di blocco si aspettano gli ottetti di un 



//indirizzo ip in ordine rovesciato 



StringBuffer sb = new StringBuffer(); 
StringTokenizer st = new StringTokenizer(host, " 

.", false); 



while (st.hasMoreTokensQ) { 



sb.insert(0, st.nextToken() + ".");} 
//aggiunge il prefisso di rete della lista di blocco 



//ad esempio sbl.spamhaus.org 



sb.append (network); 



//ricerca tramite DNS 



org. a pache.james.dnsserver. DNSServer 

.getByName( sb.toStringO); 
//se l'indirizzo viene trovato vuol dire che è 

presente in black list 



return mail.getRecipients(); 



} catch (UnknownHostException uhe) { 
//in caso contrario l'indirizzo è "pulito" 



return nuli;} 



} 

(codice sotto licenza Apache License, Version 2.0) 

L'indirizzo sbl.spamhaus.org non punta ad un vero 
server. Se si richiede questo indirizzo con un brow- 
ser si ottiene un errore. In realtà l'indirizzo punta a 
zone DNS bilanciate per il carico. Ciascuna zona è 
infatti suddivisa in più sottozone, distribuite in 
tutto il mondo. Ed i vari server DNS sono connessi 
tra di loro con canali ad alte prestazioni. 
Inoltre, i DNS di Spamhaus sono implementati per 
le prestazioni. Questi aspetti permettono di otte- 
nere tempi di interrogazione molto bassi, nell'or- 
dine di millisecondi. 

Inoltre, i risultati vengono inseriti in una cache per 
un certo periodo, in modo tale che le successive 
interrogazioni siano ancora più veloci. Ne conse- 
gue che non esiste un effettivo rallentamento del 
server di posta se questo implementa un filtro 
contro la posta spazzatura basato su liste di bloc- 
co. Inoltre, i moderni server elaborano i messaggi 
in parallelo, dunque anche se esiste un minimo 
ritardo nell'elaborazione di un messaggio, questo 
non rallenta l'operazione complessiva. 

Massimiliano Bigatti 





SUL WEB 



Gli indirizzi dei databa- 
se di mittenti di posta 
spazzatura sono i se- 
guenti: 

The SpamHaus Project 

http://www.spamhaus.org/ 

The Abusive Hosts 
Blocking List 

http://www.ahbl.org/ 

SpamCop.net 

http://www.spamcop.net 
/bl.shtml 

Distributed Sender 
Blackhole List 

http://dsbl.org/main . 

I servizi offerti sono 
completamente 
gratuiti. Potete 
usufruirne sia se siete 
un gestore di mail 
server, sia se siete un 
utente comune che 
vuole segnalare uno 
spammer. 




PER SAPERNE 
DI PIÙ 



DNS 

I siti che forniscono 
l'accesso ai database 
degli indirizzi IP 
sospetti supportano 
query sotto forma di 
risoluzione di nome 
DNS. Quest'ultima è la 
tecnologia che viene 
utilizzata su Internet 
per la risoluzione dei 
nomi. Tra i vantaggi, la 
forte distribuzione e 
ridondanza dei dati. 
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Intel C++ Compiler 
un mostro di velocità 

C++ è il linguaggio principe per ottenere prestazioni e controllo 
della macchina. Il compilatore Intel genera un assembly talmente 
ottimizzato da ottenere prestazioni 100 volte superiori alla media 




M 




Tempo di realizzazione 



olte aree della programmazione, 
come il calcolo scientifico, la mani- 
polazione real-time dei segnali e 
delle immagini e l'Intelligenza Artificiale, 
hanno in comune la necessità di prestazioni 
molto elevate. In questi casi una corretta otti- 
mizzazione del codice non è sufficiente a 
garantire la velocità richiesta; la programma- 
zione in un linguaggio d'alto livello, per quan- 
to comodo e flessibile come il C++, comincia 
ad andare stretta, e diventa obbligatorio dare 
attenzione a tutti quei passaggi invisibili, che 
avvengono al di là della sfera d'influenza del 
programmatore. Quest'ultimo è quindi co- 
stretto o a cambiare linguaggio (con tutti i 
problemi relativi alla programmazione diretta 
in assembler), o ad affidarsi alla delicata pra- 
tica del fine-tuning delle prestazioni, da otte- 
nere mediante le direttive e le opzioni che il 
compilatore mette a sua disposizione. In que- 
st'ultimo caso è facilmente immaginabile 
quanto la scelta del compilatore più adatto 
alle proprie esigenze giochi un ruolo tanto 
fondamentale quanto complesso. La maggior 
parte dei compilatori fornisce tutta una serie 
di funzionalità ormai considerate classiche e 
quasi "tradizionali": semplificare il codice 
ridondante, eliminare potenziali ambiguità 
dei riferimenti in memoria, e molte altre. Una 
simile compilazione produce codice general- 
mente aderente alle specifiche dell'IA-32, le 
quali offrono la garanzia di essere supportate 
dalla maggior parte dei processori per PC in 
commercio. Questo permette al programma- 
tore di ottenere una buona compatibilità, ma 
al prezzo di sacrificare il proprio software ad 
un'architettura che si porta sulle spalle il peso 
dei suoi vent'anni, senza tener conto delle 
diverse innovazioni che ogni casa ha apporta- 
to ai propri instruction set. La direzione op- 
posta è quella di compilare per uno specifico 
modello di processore, traendo vantaggio dal- 



la possibilità di appoggiarsi su specifiche si- 
cure e avanzate, ma tagliando inesorabilmen- 
te fuori la vasta utenza che non fa uso dell'ar- 
chitettura di volta in volta prevista, o dissan- 
guandosi in un versioning capillarmente dif- 
ferenziato, poco manutenibile e molto pesan- 
te. Tutte queste problematiche introducono al 
fatto che non esiste una scelta assoluta, in 
merito di compilatori, ma questa va progetta- 
ta ad-hoc, valutando ogni volta (quantome- 
no) gli strumenti disponibili, le architetture di 
destinazione, le prestazioni desiderate e l'u- 
tenza di riferimento. Fra il ventaglio di possi- 
bilità disponibili, sarebbe certo un errore non 
prendere in considerazione il compilatore di 
uno dei leader indiscussi nel campo dei pro- 
cessori: l'Intel C++ Compiler (ICC). 



INTEL COMPILER 

ICC presenta un numero di caratteristiche che 
lo rendono un prodotto interessante: 



È disponibile sia per Linux(gratuito per 
progetti non commerciali), sia per Win- 
dows. 

Si integra automaticamente con gli IDE 
Eclipse (Linux) e Visual Studio (Windows) . 
Ha ottime prestazioni su processori Intel, e 
permette di trarre vantaggio dalle diverse 
caratteristiche di ogni singolo modello 
(sfruttando i relativi instruction-set, dal- 
l'MMX fino alle recenti SSE3). 
Offre un'elegante via d'uscita al succitato 
problema scalabilità/ specificità, grazie al 
meccanismo del dispatching. 
Permette di compilare per architetture In- 
tel 64-Bite Itanium-based (1 e 2). 
Si adatta in modo naturale ad essere abbi- 
nato ad altri strumenti avanzatinelle aree 
che più necessitano di prestazioni elevate: 
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tre esempi su tutti sono rappresentati dalle 
OpenMPper la programmazione parallela, 
OpenCV, per il riconoscimento visuale e le 
IPP (Intel Performance Primitives) una li- 
breria che permette di aumentare le presta- 
zioni in una vasta gamma di applicazioni. 

La combinazione con uno o più di questi stru- 
menti è sicuramente il modo migliore di spin- 
gere a pieno regime la potenza del compilato- 
re. Proprio per questo motivo, introdurrò in 
queste pagine l'uso del compilatore e, in un 
successivo appuntamento, mostrerò l'integra- 
zione con le IPP. Impareremo così i principi 
fondamentali di questi due potenti strumenti: 
dalla loro installazione e integrazione in IDE, 
ad una panoramica sommaria delle loro fun- 
zioni. 



INSTALLAZIONE 
DEL COMPILATORE 

Come accennato precedentemente, il compi- 
latore C++ dell'Intel è disponibile sia per Li- 
nux (dov'è gratuito per programmi non-com- 
merciali) sia per Windows, al costo di circa 
400$ o in versione trial per 30 giorni. In questa 
sede ci occuperemo dell'installazione del 
compilatore in ambiente Windows, e della sua 
integrazione con Visual Studio 6. Con pochi 
cambiamenti, lo stesso discorso può essere 
facilmente trasposto per i possessori di un 
sistema Linux (dove possibile vedremo anche 
le varianti Linux di quanto esposto). Il primo 
passo consiste nello scaricare la versione 
dimostrativa del compilatore (127 Mb), all'in- 
dirizzo http://www.intel.com/software/products 
lcompilersldownloadslcwin_eval.htm e installare il 
prodotto, previa registrazione alla pagina 
https:llregistrationcenter.intel.com/EvalCenter 
/EvalForm.aspx?ProductID=287. Quest'ultima è 
necessaria, per ottenere il numero di serie e 
della chiave di licenza, che vengono inviati via 
e-mail (il numero di serie è nel testo e la chia- 
ve è allegata), e sono richiesti per sbloccare 
l'installazione del kit "Intel® C++ Compiler 
8.1 for Windows*". Una volta portata a termi- 
ne quest'ultima, ritroverete nel menu d'avvio 




la voce "Intel(R) Software Development Tools", 
al cui interno è presente tutto il necessario 
per iniziare. Per fare una prova, possiamo usa- 
re il compilatore via riga di comando (il modo 
più semplice e pratico), selezionando "Build 
Environment for IA-32 applications". Questo 
ci permette di accedere al prompt dei coman- 
di, con tutte le variabili d'ambiente già inizia- 
lizzate in maniera automatica e corretta. Tutto 
quel che ci resta da fare è semplicemente 
creare il nostro file e compilare. Compilare un 
ipotetico file "Hello_World.cpp" col minimo 
delle opzioni, ad esempio, corrisponde sem- 
plicemente a passare il comando: 

> ìcl Hello_World.cpp 

a seguito del quale riceveremo la pronta ri- 
sposta del compilatore, ovverosia qualcosa di 
simile a quanto riportato in Figura 1. Il nostro 
hello_world.exe è il primo programma gene- 
rato dal compilatore! 



USO DEL COMPILATORE 
VIA CLI 

Possiamo usare il prompt dei comandi per co- 
minciare ad introdurre qualche opzione del 
compilatore, e mostrarne l'efficacia. 
Immaginiamo di avere un programma chia- 
mato test.cpp, come quello che segue: 

#include <stdio.h> 

#include <time.h> 

#define MAX_I 2500 

#define MAX_J 2500 

float n[MAX_I]; 

float average(float il, float i2) 

1 

return float(il + i2)/2.0; 

1 

main() 

1 

//inizio timer 

clock_t IStart, lEnd; 

IStart = clock(); 

//computazione di prova 

for (long i = l; i<MAX_I; i+ + ) { 

float f=0; 

for (long j = l; j<MAX_J; j + + ) { 
f += average(f,j); 

if (int(f)%2) 

f += average(f,i); 





GLOSSARIO 



L'IA-32 

(altrimenti noto come 
Ì386), nasce nel 1985, 
ed è usato ancora oggi 
come ISA di base, per 
la garantire il livello 
minimo di compatibi- 
lità fra CPU apparte- 
nenti alla famiglia x86. 
Si basa su otto registri 
"general purpose" a 
32 bit. 



MMX 

(possibile acronimo di 
MultiMedia eXtension) 
è il primo Instruction- 
Set Intel (Pentium II) di 
tipo SIMD, dotato di 
un vettore di otto regi- 
stri a 64 bit. 



Fig. 1: Output della compilazione del programma 
Hello_ World, cpp 



n[i]=f; 

_} 

//fine timer 
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lEnd = clock(); 




printf("%f secondi' 


, (double)(IEnd-IStart) 

/CLOCKS_PER_SEC); 


} 




SSE 

(Streaming SIMD Ex- 
tension), è un'esten- 
sione avanzata all'in- 
struction set MMX, 
introdotta con il Pen- 
tium III. Include otto 
nuovi registri a 128 bit 
(da xmmO a xmm7), 
utilizzabili per memo- 
rizzare, al massimo, 
quattro numeri in 
virgola mobile. 



È un'estensione a SSE, 
introdotta con il Pen- 
tium IV con l'intenzio- 
ne di soppiantare com- 
pletamente MMX, che 
permette (fra le altre 
cose) l'uso di numeri 
in virgola mobile a 
doppia precisione sui 
registri e operazioni su 
interi a 64 bit. 



Si tratta di un piccolo test che calcola una fun- 
zione matematica priva di utilità pratica, ma 
che ha il grande pregio di operare una buona 
varietà di operazioni su numeri in virgola 
mobile, di "float compare and branch", di con- 
versioni da float a int e viceversa, e di chiama- 
te a funzione (average). La funzione potrebbe 
apparire singolare, ma è stata progettata ad- 
hoc per trarre vantaggio dalle caratteristiche 
più avanzate delle architetture Intel più 
recenti, e far risaltare particolarmente l'effet- 
to delle ottimizzazioni che seguiranno. 
Proviamo, per cominciare, a compilarla con il 
minimo delle opzioni, passando il comando: 

> icl test.cpp 

La schermata risultante (simile a quella in 
Figurai), ci dirà che la compilazione è pronta, 
e che ha generato i file posti di seguito a 
"-out:": test.obj, e il relativo test.exe, quest'ul- 
timo ottenuto tramite il linker Microsoft. 
Possiamo provare a fare girare il file test.exe e 
vedere quanto impiega l'esecuzione: su un 
Pentium 4 a 2400 Mhz con 256 Mb di RAM il 
responso è circa 10.3 secondi. Un tempo che 
vogliamo migliorare avvalendoci di ottimizza- 
zioni mirate. 

In primo luogo, si può osservare che il codice 
spende la maggior parte del tempo nel ciclo 
più interno, nel quale esegue un numero 
significativo di chiamate alla funzione avera- 
ge. In questi casi ci si può avvalere dell'Inter- 
Procedural Optimization (IPO), che cerca di 
espandere le funzioni e ottimizzare le relative 
chiamate. Con il seguente comando: 

> icl -Qip test.cpp-o:testIpo.exe 

creiamo un file con ottimizzazione interpro- 
cedurale (opzione -Qip), di nome testIpo.exe 
(opzione -o:). Sempre sullo stesso Pentium 4, 
il risultato impiega circa 2.8 secondi: è quasi 
quattro volte più veloce della versione non- 
ottimizzata. 



Windows 


Linux 


Effetto 


-Qip 


-ip 


Applica le ottimizzazioni interprocedurali. 


-QxP 


-XP 


Ottimizza per Prescott (SSE3). 


-QxB 


-xB 


Ottimizza per Pentium M e compatibili. 


-QxN 


-xN 


Ottimizza per Pentium IV e compatibili. 


-QxK 


-xK 


Ottimizza per Pentium III e compatibili 


-Qax[P\B\N\KI 


-ox[P\B\N\K] 


Come Qx*, con CPU dispatching. 


, Tabella 1. Un elenco delle opzioni di compilazione , 



DISPATCHIMG 

Tramite TIPO, siamo arrivati a ridurre il tempo 
di esecuzione di circa un quarto. Dal momen- 
to che più volte abbiamo detto di effettuare i 
nostri test su un Pentium 4, e che la funzione 
è stata creata con quest'architettura in mente, 
potremmo pensare di ottimizzare il risultato 
specificamente per questo processore. Dalla 
Tabella 1, che elenca anche un buon numero di 
opzioni di compilazione per altri modelli spe- 
cifici, ricaviamo che lo switch da usare è 
-QxN. A riga di comando, quindi, passiamo: 

> icl -Qip -QxN test.cpp-o:testIpoP4.exe 

Su un Pentium 4, otterremo un risultato entu- 
siasmante: il programma impiega circa 0.1 
secondi, ovverosia 100 volte meno della 
nostra prima compilazione! 
Si tratta di una gioia che potremo dividere con 
tutti coloro che possiedono lo stesso modello 
per il quale abbiamo compilato. E, purtroppo, 
solo con loro! Se facciamo girare il program- 
ma su un processore non compatibile con 
l'architettura di destinazione non otterremo 
altro che un laconico ed inappellabile mes- 
saggio: "Fatai Error: This program was not 
built to run on the processor on your system". 
Addio compatibilità! 

Si tratta, come additavo nel paragrafo intro- 
duttivo, di un problema tipico dei compilato- 
ri: o si usano strutture avanzate e specifiche (e 
veloci), oppure ci si accontenta di prestazioni 
più modeste ma più compatibili. Nello stesso 
paragrafo, però, accennavo anche di un'inte- 
ressante soluzione che ICC mette a disposi- 
zione dello sviluppatore: il CPU dispatching. 
Quando si sceglie di usare un'opzione che 
impiega questo sistema, il compilatore genera 
due diverse versioni di ogni funzione ottimiz- 
zabile, e memorizza sia quella basata sull'ar- 
chitettura specifica, sia quella più lenta, ma 
compatibile con lo standard Ì386. 
Quando l'eseguibile risultante viene avviato, il 
programma verifica automaticamente se il 
sistema supporta il modello per il quale si è 
ottimizzato, e si comporta di conseguenza. In 
questo modo si può ottenere, al prezzo di una 
minima riduzione di performance per il runti- 
me checking, un file singolo che gira veloce 
sulle macchine previste, e che gira ugualmen- 
te (con minor prestazioni), su un sistema dif- 
ferente. 

Per usare il dispatching basta trasformare il 
prefisso "-Qx" in "-Qxa". Quindi con la seguen- 
te riga: 

> icl -Qip -QxaN test.cpp -o:testIpoP4_D.exe 
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compileremo il file con le stesse opzioni di 
prima, con l'aggiunta del dispatching. Il risul- 
tato gira sempre in 0.1 secondi con un 
Pentium 4 (in questo caso la velocità non ha 
risentito dei controlli runtime) e, in più, il 
nostro programma è sempre compatibile con 
architetture Ì386, per le quali vale comunque 
l'ottimizzazione interprocedurale "-Qip". 
Il meccanismo di CPU dispatching avviene in 
automatico, con la possibilità di definire fino 
a tre possibili percorsi. La vera potenza di 
questo sistema, però, si apprezza nella versio- 
ne manuale: potendo scrivere fino a sette ver- 
sioni della stessa funzione, ognuna per un 
diverso tipo d'architettura. 
Vedere in dettaglio questa funzionalità, pur- 
troppo, richiederebbe ben più spazio di quan- 
to racchiuso fra queste poche pagine. Per ana- 
lizzare degli esempi di dispatching manuale 
dei processori, così come per studiare le deci- 
ne d'altre opzioni che il compilatore permette 
di usare (e che vale la pena di conoscere a 
fondo), è possibile consultare il manuale in 
linea, e i relativi tutorial. 



UNO SGUARDO VERSO 
IL BASSO 

Immaginiamo di avere un codice come quello 
che segue: 

#include <stdio.h> 
#define MAX_I 10000 



main() 



{ 



long n[MAX_I]; 



printf("Inizio computazione!"); 



for (int i=0; i<MAX_I; i++) 



n[l] 



printf("Fine computazione!"); 



} 



È abbastanza evidente che si tratta di un pro- 
gramma che inizializza un vettore di MAX_I 
elementi con un indice crescente. 
Un'applicazione tanto semplice ci permette di 
dare un'occhiata al codice assembler generato 
dal compilatore, senza troppo timore. 
Per raggiungere questo scopo, possiamo pas- 
sare la direttiva: 

> icl -Fa -01 test.cpp 

In questo caso, lo switch -01 indica di conte- 
nere le ottimizzazioni al minimo (rendendoci, 
così, i passaggi più chiari), mentre -Fa richie- 
de in output il file test, asm contenente il codi- 



ce assembler generato. 

Aprendolo col nostro editor preferito otterre- 
mo il listato, di cui questo è l'estratto saliente, 
relativo al ciclo: 



$B1$2: 


; Preds $B1$8 


xor 


eax, eax //i=0; ;10.11 


; LOE eax ebx esi edi 


$B1$3: 


; Preds $B1$3 $B1$2 


mov 


DWORD PTR [esp+eax*4], eax 

//n[i] = i; ;11.3 


ine 


eax //i+ + ; ;10.25 


emp 


eax, 10000 //if (i<10000) ;10.2 


jl 


$B1$3 ; Prob 99% //goto $B1$3; ;10.2 



Credo che il codice sia facilmente comprensi- 
bile: per maggiore chiarezza, ad ogni modo, 
ho anche aggiunto dei commenti "in stile 
C++" a fianco di ogni istruzione. In questo 
piccolo estratto è possibile notare la suddivi- 
sione del codice in blocchi ($BX$Y), la corri- 
spondenza a destra con le righe del file sor- 
gente (ad esempio, 10.11, indica "riga 10, 
colonna 11"), la lista dei registri Live On Exit 
(LOE), la lista dei predecessori (Preds), e l'in- 
dice di probabilità associato automaticamen- 
te a ciascun'istruzione di salto (Prob). 
Guardare il codice assembler generato dal 
compilatore è il modo migliore per capire 
cosa succede in seguito ad un'ottimizzazione. 
Proviamo, ad esempio, a ricompilare test.cpp, 
stavolta senza la limitazione imposta da -Ol 
(ovvero scrivendo solo "icl -Fa", dal momento 
che -02 è lo standard): 



$B1$2: 


; Preds $B1$8 


xor 


esi, esi 


10.11 


mov 


ebx, 1 


10.11 


mov 


ecx, 2 ; 


10.11 


mov 


edx, 3 


10.11 


mov 


eax, 4 , 


10.11 


; LOE 


eax edx ecx ebx esi edi 




$B1$3: 


; Preds $B1$3 $B1$2 




mov 


DWORD PTR [esp+esi*4], esi ;11 


.3 


mov 


DWORD PTR [esp+esi*4+4], ebx 


11.3 


mov 


DWORD PTR [esp+esi*4+8], ecx , 


11.3 


add 


ebx, 5 ;10.25 




add 


ecx, 5 ;10.25 




mov 


DWORD PTR [esp+esi*4+12], edx 


;11.3 


mov 


DWORD PTR [esp+esi*4+16], eax 


;11.3 


add 


edx, 5 ;10.25 




add 


eax, 5 ;10.25 




add 


esi, 5 ;10.25 




emp 


esi, 10000 ;10.2 




jl 


$B1$3 ; Prob 99% ;10.2 





Se non siamo abituati a certe ottimizzazioni, 
forse ci sembrerà strano che il codice si sia 





GLOSSARIO 



SSE3 

introdotta con la 
revisione Prescott del 
Pentium IV, è 
un'estensione di SSE2. 
Fra le altre 

innovazioni, permette 
di lavorare 
orizzontalmente sui 
registri xmm. 



OPENMP 

È uno standard di API 
per la programmazione 
in Fortran, C e C++ in 
architetture parallele. 
Usato in una vasta 
gamma di applicazioni 
e di sistemi operativi 
(fra i quali Linux, Unix 
e Windows), permette 
di scrivere applicazioni 
per un raggio di 
macchine che va dal PC 
al supercomputer, ai 
cluster per il calcolo 
parallelo. 
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OPEIMCV 

È una libreria open- 

source molto potente e 

versatile mirata 

principalmente al 

riconoscimento 

visuale: è usata in una 

vasta gamma di 

applicazioni che va dal 

riconoscimento 

facciale e delle 

impronte digitali alla 

robotica. È basata sulle 

Intel Performance 

Primitives. 



IPP 

"Intel Performance 

Primitives" è una 

libreria Intel che 

permette al 

programmatore di 

disporre di una serie di 

funzioni atomiche e 

molto veloci che 

consentono di 

migliorare le 

prestazioni in una 

gamma di applicazioni 

che comprende la 

manipolazione dei 

segnali, delle immagini 

e delle matrici. 



IDE 

ICC si integra con 

Eclipse (Linux) e Visual 

Studio (Windows). È 

anche compatibile con 

Visual Studio.NET, 

sebbene manchi 

ancora il supporto alle 

managed estensions, 

all'event handling, 

all'attribute code, e, in 

generale, 

l'integrazione con tutti 

quei progetti 

specificamente marcati 

come .NET. 



allungato, anziché accorciarsi! A dimostrazio- 
ne che l'identità "lungo == lento" è quanto- 
meno fuorviante, il compilatore ha "srotolato" 
il ciclo. Per farlo, si è appoggiato su più registri 
(eax, ebx, ecx, edx ed esi), incrementandoli di 
cinque unità per volta. Questo permette di 
ridurre di un quinto il numero dei salti, velo- 
cizzando così l'esecuzione. Il "loop unrolling" 
fa parte del gruppo di ottimizzazioni attivabi- 
li con -02, e può essere personalizzato con la 
direttiva "-Qunroll[n]", dove n è il livello desi- 
derato. 



AUTO-VECTORIZATIOHI 

Nelle analisi precedenti, abbiamo visto solo 
comparire istruzioni perfettamente aderenti 
all'IA-32. Tutte le ottimizzazioni fatte, quindi, 
gireranno sulla maggior parte delle CPU, ma 
sappiamo che gli incrementi di prestazioni 
maggiori arrivano quando si sfruttano istruc- 
tion-set più avanzati. 

Il concetto che sta dietro queste architetture è 
quasi sempre lo stesso, ed è sintetizzabile con 
un acronimo: SIMD (Single Instruction, Mul- 
tiple Data), ovvero singole istruzioni capaci di 
sfruttare il parallelismo del processore (quan- 
do c'è) per eseguire con un solo ciclo un'ope- 
razione su più dati. Il compilatore Intel in gra- 
do di avvalersi degli istruction-set MMX, SSE, 
SSE2 e SSE3 in modo proficuo (a differenza di 
GCC, che ancora manca quest'obiettivo), dal 
momento che permette una gestione della 
memoria già allineata in maniera corretta e 
offre supporto per la "auto-vectorization", ov- 
vero il riconoscimento automatico di quei 
cicli in cui è possibile applicare con successo 
istruzioni parallele. 

Possiamo provare a trarne un saggio, compi- 
lando il nostro test.cpp del paragrafo prece- 
dente, con le seguenti opzioni: 

> icl -01 -QxP test.cpp 

Come sappiamo, -01 impedisce alcune otti- 
mizzazioni che complicherebbero l'analisi 
(loop unrolling), e -QxP indica al compilatore 
di ottimizzare per Prescott, rendendo lecita 
l'auto-vectorization. La risposta del compila- 
tore sarà simile alle solite, ma conterrà una 
riga in più: 

"test.cpp(lO) : (col. 2) remark. LOOP WAS VECTORIZED." 

È il segnale che il compilatore si è accorto che 
il nostro ciclo d'assegnamento è vettorizzabi- 
le, ed è riuscito a trasformarlo. 



_RDATA SEGMENT DWORD PUBLIC FLAT 'DATA' 
_2il0floatpacket$l DD 000000004H,000000004H, 

000000004H,000000004H 
_2il0floatpacket$3 DD 000000000H,000000001H, 

000000002H,000000003H 

_RDATA ENDS 



$B1$2: 



Preds $B1$8 



movdqa xmmO, XMMWORD PTR 

_2M0floatpacket$l 



;10.25 



movdqa xmml, XMMWORD PTR 

_2M0floatpacket$3 



;10.25 



eax, eax 



;10.2 



LOE eax ebx esi edi xmmO xmml 



$B1$3: 



Preds $B1$3 $B1$2 



movdqa XMMWORD PTR [esp+eax*4], xmml ;11.3 



paddd 



xmml, xmmO 



;10.25 



add 



eax, 4 



;10.2 



cmp 



eax, 10000 



;10.2 



jb 



$B1$3 



Prob 99% 



;10.2 



; LOE eax ebx esi edi xmmO xmml 

E questa è la trasposizione. Ho riportato solo 
gli stralci significativi per la comprensione del 
ciclo. Innanzitutto si può notare la dichiara- 
zione di due "pacchetti" dati, impostati a 
[4,4,4,4] e [0,1,2,3]. In $B1$2, al solito, è pre- 
sente l'inizializzazione delle variabili: vengo- 
no caricati nei registri xmmO e xmml i due 
pacchetti, ed eax viene posto a zero. Le cinque 
righe di $B1$3, invece, contengono il cuore 
del ciclo e due istruzioni non IA-32: Paddde 
movdqa, infatti, sono istruzioni SSE2, e sfrut- 
tano l'architettura parallela del processore 
per eseguire rispettivamente somme e sposta- 
menti di quattro elementi di 32 bit, con una 
sola istruzione. 

Seguiamo la prima iterazione del ciclo per 
comprenderne bene il funzionamento. 

• Riga 1: Nei primi quattro elementi di n a 
partire da eax, vengono memorizzati i 
quattro di xmml. {eax = 0, quindi: n[0]=0, 
n[l]=l,n[2]=2,n[3]=3). 

• Riga 2: Ogni elemento di xmml viene incre- 
mentato di 4, tramite somma con xmmO. 
(infatti, xmml += xmmO = [0,1,2,3] + [4,4,4,4] 
=[4,5,6,7]) 

• Riga 3: eax viene incrementato di quattro 
unità. La prossima iterazione varrà per i 
quattro elementi di n successivi (eax = 4). 

• Riga 4 e 5: Se eax < 10000 ripete il ciclo. 

Tutto questo permette di velocizzare il ciclo 
(almeno) di un fattore 4, sfruttando l'architet- 
tura parallela dei processori Pentium succes- 
sivi al IV. 
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Potete provare a compilare il programma 
senza la restrizione -Ol, e vedere l'integrazio- 
ne automatica fra "loop-unrolling" e "auto- 
vectorization". 



ICC ll\l VISUAL STUDIO 6 

Attraverso la shell si può fare di tutto, ma aiu- 
tarsi con un buon IDE è sicuramente più pra- 
tico. L'integrazione di ICC in Visual Studio è 
resa molto semplice dallo strumento "Intel 
Compiler Selection" che viene automaticamente 
aggiunto all'IDE di Visual Studio, nel menù 
Tools, a seguito dell'installazione. Questa vo- 
ce permette di accedere alla finestra di sele- 
zione (visibile in Figura 2), all'interno della 
quale è possibile scegliere se abilitare o meno 
il compilatore, e per quale versione (normal- 
mente, si vorrà usare la 8.0), sia il normale 32 



Selection Tool 



IA-32 Compiler Selection 
!• Intel® C++ Compiler 



Q^l H^J Version 
Uses environment variables in Tools->Options->Directories 



DK 



Help 



Intel® Itanium® Compiler / Environment Selection 

REQUIRES CHANGES T0 PROJECT SETTINGS! SEE "Help" 
You must add WIN 64 and /machine: ia64 to compiler, linker and 
librarian settings to invoke any Intel® Itanium® compiler. Without 
these options, you will get an IA-32 compilation. 

I - Intel® C++ Compiler 3 Version 

I - U eEri uonni-rti' ■■ bn bt-le Li 'ed F^elo 1 ■ 

Overrides environment variables in Tools->Options->Directories 

Patii | 
Include \ 
Lib | 



Fig. 2: La finestra che ci consente di abilitare o meno 
il compilatore 



bit (nella parte alta della finestra), o il 64 bit 
per Itanium (in quella bassa). 
Alla successiva compilazione, i file saranno 
processati con l'ICC, invece che col compila- 
tore Microsoft: il linker, infatti, viene sostitui- 
to dal file "xilink6.exe", che si prende cura di 
effettuare questo passaggio. Come sempre, le 
opzioni dirette al compilatore possono essere 
raggiunte attraverso il menù Projects /Set- 
tings, dalla cui finestra possono essere scelti 
gli switch da passare alla riga di comando. 
Una delle caratteristiche più interessanti di 
questo sistema, è che si può agevolmente 
trarre vantaggio dal meglio di entrambi i com- 
pilatori: è infatti possibile scegliere di compi- 
lare solo alcuni file del progetto mediante ICC 
ed altri con il compilatore Microsoft. Per rag- 
giungere quest'obiettivo è sufficiente: 



Settings Fon Win32 R 



ly. :i:' Vii. 

■ _J Scuice Files 

jQ codiceConii-lìi.cp: 

m — 

CJ Headei Files 
■■□ ResoLirceFile 



General C/L>+ 














Categoiit 1 General 




_rj Rese! | 


\Vaming level: 
Level 3 


•1 


Optimizations: 

| Maximo Speed jj 


Wainings as erro 
3ebug info: 




Generate browse info 


n™ 




d 


5 re processor definiiions: 




USE_N0N_INTEL_ 


COMPILER 


Source File Options; 







< V- and/02. and 



Fig. 3: Tramite questa finestra si può scegliere se uti- 
lizzare o meno il compilatore di intel 

1. Selezionare il compilatore cui si desidera 
destinare la maggior parte dei file, con l'ap- 
posito Tool. 

2. Andare su Project! Settings. . . 

3. Selezionare il file che si vuole compilare 
mediante l'altro compilatore, nella lista a 
sinistra (come mostrato in Figura 3). 

4. Indicare al preprocessore "USE_NON_ IN- 
TEL_COMPILER", nel caso si voglia usare Mi- 
crosoft (è il caso in figura), oppure "USE_ 
INTELjCOMPIEER" in caso contrario. 

Se si esclude l'attività di debugging diretta 
con ICC (per la quale è possibile usare l'appo- 
sito debugger, in versione GUI o a linea di 
comando), queste semplici direttive permet- 
tono di usare senza problemi l'Intel Compiler 
in ambiente Visual Studio. 



CONCLUSIONI 

Lascio nelle vostre mani un confronto fra il 
compilatore dell'Intel, GCC e Visual C++: un 
paragone che mi sono guardato bene dal pro- 
porre in questa sede. 

Le tabelle dei benchmark dei compilatori, 
infatti, per quanto possano apparire professio- 
nali, sono notoriamente poco indicative e 
rischiano sempre di essere poco oggettive. 
Molto meglio, invece, affinare in modo pratico 
la propria competenza, sapendo per esperienza 
quando usare uno strumento, invece che un 
altro. L'ICC, con il supporto alla programma- 
zione parallela, l'autovectorization, il dispat- 
ching automatico e manuale, l'ottimizzazione 
per profili, la compatibilità con Visual Studio ed 
Eclipse, la licenza free in ambito non-commer- 
ciale Linux, e molte altre qualità. . . è un attrezzo 
da tenere in bella mostra nella propria cassetta 
degli attrezzi 

Roberto Allegra 





PGO 

La Profile Guided Opti- 
mization (PGO) è un 
tipo di ottimizzazione 
"multi-pass" che si può 
richiedere a ICC me- 
diante le direttive 
-Qprof_gen e 
-Qprof use. Queste 
permettono di ottimiz- 
zare il codice dinamica- 
mente cercando di far 
capire al compilatore 
in automatico quali 
ottimizzazioni sono più 
indicate, attraverso più 
esecuzioni di prova. 




CONTATTA 
L'AUTORE 



Per qualsiasi critica, 
suggerimento o 
richiesta l'autore può 
essere contattato 
all'indirizzo 
roberto.alleqra® 
ioprogrammo.it . 
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JavaMail 



Una WebMail per 
cellulari con JavaMail 

Spedire e ricevere posta elettronica è ormai una necessità per ogni 
applicazione che si rispetti. Vediamo quali sono le classi messe 
a disposizione dal linguaggio di Sun per questo scopo 




□ ( 



CD □ WEB 

la\iamail.zip 




REQUISITI 



Conoscenze richieste 



BasidiJ2SE 



J2SE SDK, J2EE , 
JavaMail 1.3, 
JAF 1.0.2 



i^i^ai^a _-i 



Tempo di realizzazione 



Per il prossimo anno gli analisti stimano 
in 60 miliardi il numero di email scam- 
biate giornalmente. Ogni programma- 
tore deve tenere bene in mente che è alta- 
mente probabile che nei propri programmi 
avrà necessità di inserire un modulo per l'in- 
vio o la ricezione delle email. Considerate il 
più semplice dei casi: dare un feedback all'u- 
tente per la ricezione di un ordine. 
In ogni linguaggio che si rispetti esistono del- 
le librerie che permettono allo sviluppatore di 
interfacciarsi con i server di posta e consenti- 
re di inserire nei propri programmi funzioni 
relative alla gestione dell'email. 
In Java le librerie che assolvono a questo 
scopo sono le JavaMail. Si tratta di un fra- 
mework sviluppato dalla SUN che permette la 
comunicazione tramite i protocolli classici: 
POP3, SMTP e IMAP4. JavaMail è perfetta- 
mente compatibile con l'RFC 822, ovvero con 
lo standard email per Internet e questo con- 
sente di sviluppare applicazioni senza preoc- 
cuparsi di come la comunicazione con i vari 
server avviene. 



INVIO EMAIL 

Il nostro primo pezzo di codice assolverà al 
compito di mostrare all'utente un prompt at- 
traverso il quale fornire le informazioni relati- 
ve alla spedizione dell'email: server SMTP, de- 
stinatario, mittente, oggetto dell'email, corpo 
dell'email 



import java.utìl. 



import javax.mail. 



import javax.mail. internet.*; 



public class InvioEmail 



{ 



public static void main(String args[]) 



{ 



if (args.length<5) 



{ 



System. out.println("Inserire i parametri SMTP 
DESTINATARIO MITTENTE OGGETTO CORPO"); 



System. exit(0); 



else 



Strìng smtp=args[0]; 



String destinatario=args[l] 



String mittente=args[2]; 



String oggetto=args[3]; 



String corpo=args[4]; 



} 



catch (Exception ex) 



{System. out.println(ex.toString());} 



invia(smtp, destinatario, mittente, oggetto, corpo); 



} 



try 



} 



Abbiamo raccolto tutti i parametri necessari 
per l'invio dell'email. Non ci rimane che im- 
plementare il metodo inviai...) che sfrutterà le 
classi JavaMail contenute nei package javax 
. mail e javax. mail, internet. 
Prima di tutto definiremo un oggetto 
Properties, all'interno del quale imposteremo 
l'host del server SMTP da utilizzare. 
Successivamente inizializzeremo un oggetto 
Session, passandogli come parametro le varia- 
bili che sono state messe all'interno dell'og- 
getto Properties. Session è una classe impor- 
tante all'interno di JavaMail, perché rappre- 
senta una sessione di scambio con una casel- 
la email e contiene tutte le proprietà e i meto- 
di necessari a stabilire la comunicazione. 
Proprio grazie all'oggetto Session possiamo 
creare il messaggio da inviare, settando con 
gli opportuni metodi set tutte le informazioni 
necessarie per l'invio dell'email 
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public static void invia(String stmp,String destinatario, 
String mittente, String oggetto, String corpo) 

1 

try 

{ 

Properties props = System. getProperties(); 



props.put("mail.smtp.host", smtp); 



Session session 



Session.getDefaultInstance( 

props, nuli); 



Message msg = new MimeMessage(session); 
msg.setFrom(new InternetAddress(mittente)); 
msg. setRecipients( Message. RecipientType.TO, 

InternetAddress.parse(destinatario, false)); 
msg.setSubject(oggetto); 
msg.setText(corpo); 

msg.setHeader("X-Mailer", "ioProgrammoMailer"); 
msg.setSentDate(new Date()); 
// Finiti ì vari settaggi avviene la consegna del 

messaggio email al metodo 
// statico "send" della class Transport, la quale 

instraderà la nostra email sul 
// server che abbiamo definito 
Transport.send(msg); 
System. out.println("Messaggio inviato 

correttamente"); 

} 

catch(Exception e) 

{ 

System. out.println("Errore nell'invio dell'email");} 

} 



L'invio di un'email è un compito abbastanza 
semplice grazie a JavaMail. Senza queste clas- 
si avremmo dovuto provvedere a programma- 
re da soli una soluzione per il collegamento 
con il server SMTP. Avremmo dovuto avere co- 
noscenza delle l'RFC (Requests for Com- 
ments), e avremmo dovuto inviare via Socket 
tutte le informazioni e parsare i messaggi di 
risposta del server. Utilizzando JavaMail, in- 
vece, dobbiamo soltanto preoccuparci di 
riempire i campi necessari dell'email e conse- 
gnarla all'oggetto Transport che svolgerà tutto 
il lavoro. Per provare questa piccola classe 
dobbiamo includere nel nostro classpath mail 
.jar e activation.jar, i due file relativi rispetti- 
vamente a JavaMail e a JAF (Java Activation 
Framework). 



LETTURA EMAIL 

Per poter scaricare la posta da un server do- 
vremo fornire un indirizzo, uno username e 
una password. Sempre grazie all'oggetto Ses- 
sion, inizializzeremo uno Store che rappresen- 
terà il repository dei nostri messaggi. In que- 
sto caso ci colleghieremo ad uno Store POP3, 



ma JavaMail permette di collegarsi anche a 
server IMAP4. Il codice seguente illustra la 
procedura per effettuare la connessione e 
stampare a schermo i messaggi ricevuti 

public static void ricevi(String pop3, String 

username, String password) { 
Store store=null; 
Folder folder=null; 

try { 

Properties props = System. getPropertiesQ; 
Session session = Session. getDefaultInstance( 

props, nuli); 

store = session. getStore("pop3"); 
store. connect(pop3, username, password); 
// Una volta collegati carichiamo la directory INBOX 
// della nostra posta elettronica. Inoltre settiamo 
la cartella come READ_ONLY 
// per indicare che stiamo per leggere soltanto l'email 



folder = store. getDefaultFolder(); 



folder = folder.getFolder("INBOX"); 



folder.open(Folder.READ_ONLY); 



Message[] messaggi = folder.getMessages(); 
System. out.println("Ci sono "+messaggì.length+" 
messaggi di posta nella tua casella email");} 



catch (Exception e) { 



System. out.println(e.toString());} 



finally { 



// Cerchiamo di chiudere il Folder e lo Store, 
// anche perchè ci sono alcuni server POP3 che 
// lasciano bloccata l'email se non effettuiamo 



// questa operazione correttamente. 

try { 

if (folder! = null) folder.close(false); 
if (store! = null) store. close(); } 
catch (Exception ee) { 
System. out.println(ee.toString());} 

} 

} 



Anche la connessione con il server POP3, co- 
me appena mostrato non comporta nessun 
problema. All'interno di JavaMail è presente il 
package com.sun.mail.imap, che permette di 
interagire anche con i server IMAP4. Per que- 
st'ultimo protocollo bisogna ricordarsi della 
possibilità di creare cartelle diverse da INBOX. 
Infatti con un account IMAP4 possiamo avere 
a disposizione diverse cartelle, che possiamo 
richiamare come già abbiamo fatto per la 
casella POP3 

store = session. getStore("imap"); 

store. connect(imap, username, password); 

folder = store. getDefaultFolderQ; 

folder = folder.getFolder("EmailVecchie"); 

folder.open(Folder.READ_ONLY); 





GLOSSARIO 



SMTP (SIMPLE 
MAIL TRANSFER 
PROTOCOL) 

È il protocollo stan- 
dard per l'invio di 
email su Internet. 
Attraverso un dialogo 
che avviene tra client e 
server, si riesce ad 
inviare un messaggio 
di posta elettronica, 
specificando tutti i vari 
attributi che sono 
necessari per l'invio. 
http://www.ietf.org/rfc 
/rf c0821.txt 

POP3 (POSTAL 
OFFICE 
PROTOCOL 3) 

È un protocollo per la 
ricezione della posta 
su internet. In seguito 
ad una necessaria 
autenticazione del 
client è possibile con- 
sultare i messaggi di 
posta arrivati sul ser- 
ver, scaricarli e cancel- 
larli 

http://www.ietf.org/rfc 
/rfcl 939.txt 

IMAP4 
(INTERNET 
MESSAGE 
ACCESS 
PROTOCOL 4) 
È un ulteriore protocol- 
lo per la gestione della 
posta in arrivo. Oltre 
alle funzioni del P0P3, 
permette di organizza- 
re delle vere e proprie 
cartelle all'interno del 
server di posta 
http://www.ietf.org/rfc 
/rfcl 730.txt 
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Sono disponibili diver- 
se implementazioni an- 
che per interfacciare le 
JavaMail API con un 
server NNTP (Network 
News Transfer Proto- 
col), ovvero un server 
di news. Queste imple- 
mentazioni permetto- 
no di richiamare all'in- 
terno dell'oggetto Ses- 
sion il server NNTP e di 
gestire la connessione 
verso i newsgroup in 
maniera completamen- 
te uguale alla consulta- 
zione della casella di 
posta. 
http://www.ietf.org/rfc 
Zrfc977.txt 
http://bluezoo.org/knife/ 
http://www.vrover.org/lqpl/ 



La specifica di JavaMail 
non tratta in alcuna 
maniera la protezione 
dei dati trasmessi. Per 
fare ciò possiamo uti- 
lizzare JSSE (Java Secu- 
re Socket Extension), 
un insieme di package 
che permette di utiliz- 
zare connessioni sicure 
SSL e TLS. 
http://www.javaworld.com 
/javatips/jw-javatip1 1 5 
.html 
http://java.sun.com 
/products/jsse/ 



WEBMAIL 

PER CELLULARI 

I cellulari di ultima generazione hanno la pos- 
sibilità di navigare su internet grazie alla pre- 
senza di una versione ridotta dei browser al 
loro interno. Potremmo creare una webmail 
per consentire di leggere la posta attraverso il 
browser del cellulare. L'applicazione è abba- 
stanza semplice. È suddivisibile in due diver- 
se parti funzionali, invio e lettura email. 
Purtroppo per il momento la nostra webmail 
leggerà soltanto le email testuali, altrimenti 
dovremmo parsare l'html. Nonostante questo, 
JavaMail permette di gestire diversi formati di 
allegati. Infatti un oggetto email può contene- 
re diversi tipi di file e quindi avere diversi tipi 
di content-type. Attraverso l'interfaccia Part, 
definita in JavaMail, possiamo controllare di 
quanti parti è composta la nostra email e so- 
prattutto vedere quali sono i content-type re- 
lativi ad ogni parte. In questa applicazione 
che andremo a sviluppare, prenderemo in 
considerazione soltanto il content-type "text 
Iplain ", ovvero testo semplice. 



MENU INIZIALE 

Le pagine che vogliamo visualizzare nel brow- 
ser WAP devono essere scritte in WML (Wire- 
less Markup Language), linguaggio standard 
per il markup di pagine che devono essere vi- 
sualizzate su dispositivi come cellulari. 
Il WML è stato pensato proprio per device con 
capacità computazionali limitate tipico delle 
applicazioni che girano all'interno di un cel- 
lulare. Tutto il lavoro di generazione dinamica 
delle pagine avverrà lato server, tramite una 
servlet che, in base al metodo richiamato, ge- 
nererà pagine WML comprensibili per il no- 
stro cellulare. 

Come punto di partenza per la nostra applica- 
zione avremo un menu nel quale faremo sce- 
gliere all'utente cosa fare 

<?xml version = "1.0"?> 

<!DOCTYPE wml PUBLIC "-//WAPFORUM//DTD WML 

1.1//EN" 
"http://www.wapforum.Org/DTD/wml_l.l.xml"> 
<wmlxcard> 
<p align = "center"> 
WebMail<br/> 

<img src="Java.wbmp" alt="WebMail"/xbr/> 
<a href="http://mioserver/servetInvia" title"Invia 

Email"> Invia Email </axbr/> 
<a href="http://mioserver/servetRicevi" title"Ricevi 

Email"> Ricevi Email </a> 
</p> 



</card> 



</wml> 

Con questa pagina WML diamo all'utente la 
possibilità di scegliere tra l'invio e la ricezione 
dell'email. Queste funzionalità verranno rea- 
lizzate con 2 semplici servlet, dove dovremo 
soltanto formattare in WML l'output del codi- 
ce visto in precedenza. 



SERVLET PER L'INVIO 

Nella servlet che utilizzeremo per l'invio del- 
l'email sarà necessario suddividere due diver- 
si momenti: la generazione statica del form 
WML per inserire i dati che ci servono per la 
spedizione e la generazione dinamica del ri- 
sultato. Il metodo doGetQ conterrà il codice 
WML della pagina che ci servirà per raccoglie- 
re l'input 

public void doGet (HttpServIetRequest request, 

HttpServIetResponse response) throws 
ServIetException, IOException 

j 

PrintWriter out; 

response. setContentType("text/vnd.wap. wml"); 
out = response. getWriter(); 
out.println("<wmlxcardxp align = 'center'> 
SMTP: <input type='text' format='*M' 

emptyok='false' name='SMTP' size='10' 
maxlength = '40y><br/> 
Da: <input type='text' format='*M' emptyok= 

'false' name='From' size='10' 

maxlength = '40'/xbr/> 

A: <input type='text' format='*M' emptyok='false' 

name='To' size='10' maxlength = '40'/xbr/> 

Oggetto: <input type='text' format='*M' emptyok= 

'false' name='Subject' size='10' maxlength = 

'100'/> <br/> 

Messaggio: <input type='text' format='*M' 

emptyok='false' name='Body' size='10' 
maxlength='40'/> <br/> 
<anchor title=Tnvia'>Invia<go href='servletlnvia'> 
<postfield name='SMTP' value='$(SMTP)' /> 
<postfield name='From' value = '$(From)' /> 
<postfield name='To' value='$(To)' /> 
<postfield name='Subject' value='$(Subject)' /> 
<postfield name='Body' value='$(Body)' /> 
</gox/anchor> 
</px/cardx/wml>"); 
out.closeQ; 
} 



L'utente visualizza un form WML da riempire 
per l'invio dell'email. Cliccando su "Invia" , la 
nostra servlet vierrà richiamata e riceverà tut- 
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ti i valori necessari per l'invio. Nel metodo do- 
Post della servlet Invia quindi dovremo sem- 
plicemente riportare il codice che abbiamo 
già utilizzato per l'invio dell'email. In aggiun- 
ta dovremo caricare una pagina per permette- 
re all'utente di ritornare al menu principale 
con un semplice link. 



SERVLET 

PER LA RICEZIONE 

Anche in questo caso avremo bisogno di una 
prima schermata dove prendere le informa- 
zioni relative a server POP3, username e pas- 
sword. Quindi allo stesso modo dell'invio, ge- 
nereremo un formWML nel metodo doGet per 
acquisisre questi dati. Una volta inseriti e in- 
viati alla servlet via POST mostreremo all'u- 
tente semplicemente le email presenti nella 
sua casella di posta. 

Store store=null; 

Folder folder=null; 

Flags flag; 

Propertìes props = System. getProperties(); 

Session session = Session.getDefaultInstance( 

props, nuli); 
store = session. getStore("pop3"); 
store. connect(pop3, username, password); 
folder = store. getDefaultFolder(); 
folder = folder.getFolder("INBOX"); 
folder.open(Folder.READ_ONLY); 
Message[] messaggi = folder.getMessages(); 
int nuove=0; 

//Leggo quante nuove email ci sono nella INBOX 
for (int i = 0;i<messaggi.length;i++) 

{ 
flags = messaggì[i].getFlags(); 
boolean letto=flags.contains( Flags. Flag. SEEN); 
if (! letto) 



} 

out.println(" 

<wmlxcard> 

<p align='center'> 

Lettura Email<br/> 

Ci sono "+nuove+" nuove email su 

"-l-messaggi. Iength+" email 
<a href='http://mioserver/servetLeggi' title 

'LeggiEmail'> Leggi Email </axbr/> 
<do type="Indietro" title="indietro"> 
<prev/> </do></px/cardx/wml>" 

); 



Ora rimane da realizzare la servlet che ci per- 
mette di vedere quali email ci sono nella no- 
stra casella elettronica e di leggerle. Dovremo 



visualizzare il mittente e l'oggetto per ogni 
email, poi l'utente, tramite click nel browser 
WAP, deciderà quale email visualizzare. 
Quindi ecco come sarà il codice 

String mittente = ""; 

String oggetto = ""; 

Message[] messaggi = folder.getMessages(); 

for (int i=0;i<messaggi.length;i+ + ) 

{ 

mittente=((InternetAddress)messaggi[i].getFrom() 

)[0].getAddress(); 



oggetto= messaggi [i].getSubject(); 



out.println("<a href = 'http ://mioserver/servetLeggi? 

num = "+i+'"> "+ mittente +" - 

"+ oggetto+"</axbr/>"); 



} 



Per ogni email che andremo a visualizzare do- 
vremo prendere soltanto il testo dell'email, 
non visualizzando altre parti come immagini 
e quant'altro. Succede spesso che per colpa di 
email non formattate secondo lo standard 
RFC 822, JavaMail fallisce il parsing del mes- 
saggio. In quel caso possiamo soltanto preve- 
dere una serie di try-catch per evitare che salti 
l'intero programma. 



CONCLUSIONI 

Grazie al package JavaMail abbiamo visto co- 
me sia semplice ed immediato inviare e rice- 
vere email nel linguaggio Java. Infatti questo 
package permette allo sviluppatore di preoc- 
cuparsi soltanto della logica di business del 
proprio programma, senza dover pensare ad 
interfacciarsi direttamente con i server di po- 
sta. In questo modo la connessione, gestione 
delle cartelle, degli allegati, delle email è tra- 
sparente per lo sviluppatore. JavaMail, che at- 
tualmente è arrivato alla versione 1.3.2, ha bi- 
sogno per funzionare di JAF (Java Activation 
Framework), grazie al quale riesce a identifi- 
care e gestire i vari content-type dei messaggi 
email. Per utilizzare questo package dobbia- 
mo quindi includere i due file mail.jar e acti- 
vation. jar (rispettivamente di JavaMail e JAF) 
nel nostro classpath. Facendo parte della piat- 
taforma J2EE (Java 2 Enterprise Edition), pos- 
siamo utilizzare questo package semplice- 
mente importando le classi nella nostra appli- 
cazione Enterprise. 

È utile, tuttavia, anche dal punto di vista di 
J2SE, per la realizzazione di semplici applica- 
zioni che si appoggiano ai server di posta. 

Federico Paparoni 
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SUL WEB 



Ecco alcuni link utili: 

JavaMail 

http://java.sun.com 
/products/javamail/ 

JAF 

http://lava.sun.com/beans/ 
qlasqow/jaf.html 

Articoli tecnici della 
SUN su JavaMail 

http://java.sun.com 

/products/javamail/referen 

ce/techart/index.html 
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Fare collezione 
di Oggetti in VB 

Manipolare insiemi omogenei di strutture utilizzando VB.NET. Una 
tecnica indispensabile per aggregare i dati affinché possano essere 
analizzati e usati in maniera conveniente. 




t 



Q CD 

Corsovb.zip 



U WEB 



REQUISITI 



WM.WU.UM 



ì^"7\ Elementi Visual Basic 
*-+* ) .NET acquisiti nel corso 



H.1..WI.': 



B 



\ Sistema operativo: 
Windows 2000/XP. 
Visual Basic .NET 2003 



^3^3^3_J_ 



Tempo di realizzazione 



n natura i dati non si trovano quasi mai in forma 
singola, piuttosto vengono organizzati in insie- 
mi omogenei. Ad esempio l'insieme degli arti- 
coli prodotti per questa edizione di ioProgrammo. 
L'insieme dei film di una videoteca. Ciascuno di 
questi dati può, come sappiamo essere rappresenta- 
to da una classe che ne definisce proprietà e metodi. 
È anche vero che, instanziare un oggetto come ap- 
partenente ad una classe, non vuol dire necessaria- 
mente aggregarlo in una collezione omogenea. 
Supponiamo ad esempio di instanziare 100 oggetti 
di classe Film, fino a che non li aggreghiamo in un 
qualche modo, ognuno dei 100 oggetti Film rappre- 
senta un dato a sé stante. Esiste una classe in VB che 
definisce delle collezioni di oggetti. 
Questa classe fornisce metodi e proprietà per inseri- 
re, rimuovere o manipolare oggetti appartenenti ad 
una collezione. Ad esempio la Collection VideoTeca 
di tutti i film instanziati, espone metodi e proprietà 
per inserire o rimuovere oggetti Film dal suo inter- 
no, e altri ancora di cui parleremo proprio in questo 
articolo. 



IMPOSTARE UNA 
CLASSE COLLEZIONE 
PERSONALIZZATA 

InVB.NET sono disponibili diverse classi collezione 
native. Alcune, come Stack e Queue sono classi spe- 
cializzate implementate per svolgere ruoli specifici. 
Stack simula un insieme UFO (Last-in, first-out co- 
nosciuta anche come pila), Queue un insieme di 
oggetti FIFO {First-In First-Out conosciuta anche co- 
me coda). 

Altre classi, quali CollectionBase e DictionaryBase, 
sono classi astratte che presentano solo alcune fun- 
zionalità di base, mentre è lasciato allo sviluppatore, 
il compito di scrivere la maggior parte del codice 
d'implementazione. In VB.NET è possibile creare 



classi Collezione personalizzate, ereditando da una 
delle numerose classi collezione di .NET Framework 
e aggiungendo codice per l'implementazione di 
funzionalità necessarie ad un oggetto di tipo colle- 
zione. Nella classe CollectionBase sono già disponi- 
bili implementazioni per il metodo Clear, che per- 
mette di cancellare tutti gli oggetti di una collezione 
e la proprietà Count, che restituisce il numero di ele- 
menti presenti nella collezione. Per l'organizzazione 
e l'archiviazione interna degli oggetti viene mante- 
nuta una proprietà protetta denominata List. 
Un'altra possibilità è quella di utilizzare una classe 
nativa definita privata (per garantire l'incapsula- 
mento, che abbiamo visto essere una caratteristica 
essenziale della programmazione ad oggetti), in una 
classe con il solo compito specifico di gestire una 
collezione di oggetti. In particolare si può utilizzare 
la collezione nativa HashTable. Si tratta di un tipo di 
collezione speciale che funziona in base ad un prin- 
cipio chiave/valore, in pratica ad ogni elemento del- 
la collezione è assegnata una chiave, che può essere 
utilizzata per recuperare il valore dell'oggetto corri- 
spondente. 

Così come per le proprietà di una classe, che per 
essere lette o modificate devono esporre le procedu- 
re Property, anche per le collezioni si ha la necessità 
di avere metodi contenitori pubblici che permetta- 
no l'accesso ad una collezione privata ed ai suoi me- 
todi nativi. 



CREARE UNA CLASSE 
COLLEZIONE 

Per i nostri esempi ci appoggeremo all'applicazione 
"Videoteca" creata nei numeri precedenti di ioPro- 
grammo. Chi non avesse seguito fin qui, o non 
dispoenesse del codice necessario a seguire l'artico- 
lo, potrà comunque trovarne una versione nel ed 
allegato alla rivista. In ogni caso gli esempi sono del 
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tutto generici per cui potrete riadattarli seconco le 

vostre necessità. 

I passi per creare una nuova classe collezione sono i 

seguenti: 



S Videoteca - Microsoft Visual Basic .NET [progettazione] - Forml.vb [Progett 



File Modifica Visualizza 

e • a - & h m 



Pagina iniziale Formi, 



Progetto | Genera Debug Dati Strumenti Finestr a 
B Aggiungi 'Windows Form . . . 



^ ^ Aggiungi form ereditato. , . 

1| Aggiungi controllo utente , . . 

|H Aggiungi controllo ereditato , . 

H|] Aggiungi componente. . , 

$] Aggiungi modulo,.. 



r'J Aggiungi classe.. 



;'-:; [ Aggiungi nuovo elemento. . , CTRL+MAIUSC+A 
;V Aggiungi elemento esistente , . . MAIU5C +ALT+A 



Escludi dal progetto 
.£ Mostra tutti i file 



Aggiungi riferimento,. 



<s|E 



Iper inserire una nuova classe collezione nel 
progetto, dobbiamo selezionare dal menu 
Progetto la voce aggiungi classe. In questo modo 
sarà visualizzata la finestra di dialogo Aggiungi 
nuovo elemento. 




2 Nella finestra di dialogo Aggiungi nuovo ele- 
mento, sarà selezionato il modello Classe 
(nella parte destra della maschera). 



|iie| 



1 1+1 f^j Fomenti r|p| nmnpttn Inralp 



Windows Form Classe Modulo 



' Dichiarazione di classe vl 
Nome: [ ColFilm[vb 



J 



3 Nel campo Nome dobbiamo inserire il nome 
della classe, collezione. Esistono diverse con- 
venzioni in letteratura per l'attribuzione del 
nome ad una collezione, personalmente preferi- 
sco far precedere il nome della classe dal prefisso 
Col (ColFilm). 



B-to-tSHfflgfeBl"-"-*!'* .^bug 




- & ma 55 ,ma - . » 


. m % t, «* 9v\~e%\a%%%~ 


m P a gin a inm a | e |For m i.vb[P™tt a; ion e ]-|film.vb|For m i.vb- CbMnuvb | 


<1 > X 




m'M ii|m 


IJ? *£ColFilm -| |HI\( Dichiarazioni) 
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4 Clicchiamo sul pulsante Apn. Si aprirà la fine- 
stra di progettazione del codice di VB.NET 
con il cursore posto all'interno della dichiarazio- 
ne della classe collezione. 
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5 Nella finestra del codice (dopo l'istruzione di 
dichiarazione della classe), si deve dichiarare 
una variabile oggetto privata mCol di tipo Hash- 
table. 

Dim mcol As Hashtable 



IL CODICE DA SCRIVERE 
NEL BUTTOM CANCELLA 





I TUOI APPUNTI 



Utilizza questo spazio per 
le tue annotazioni 



Private Sub ButtonCancella_Click( 

ByVal sender As System. Object, 
ByVal e As System. EventArgs) 
Handles ButtonCancella. Click 
'Elimina l'eventuale errore che si 
'potrebbe verificare se si tenta di 
'cancellare un film non presente 
'nella collezione 
Try 
'chiamata al metodo Remove 
'passando come parametro la chiave 
'rappresentata dal titolo del film 
CollezioneDiFilm.Remove( 

TextBoxTitolo.Text) 



Catch 



End Try 



'Visualizza la nuova lista di film 



VisualizzaLista() 



'per svuotare i TextBox 



SvuotaCampiQ 



'per riportarsi nelle condizioni iniziali 



ObjFilm = Nothing 



End Sub 



II ciclo For Each...Next è simile al ci- 



clo For...Next, ma invece di ripetere 
le istruzioni il numero di volte spe- 
cificato, ripete un gruppo di istru- 
zioni per ciascun elemento di un in- 
sieme di oggetti, questo risulta 
particolarmente utile se non si co- 
nosce il numero di elementi di un 
insieme. La sintassi è la seguente: 

For Each VariabileOggetto In 

CollezioneDiOggetti 
'blocco di istruzioni da eseguire su 
'ogni oggetto della collezione 

Next 

A ogni ripetizione del ciclo, la va- 
riabile VariabileOggetto viene im- 
postata su uno degli elementi della 
collezione e viene eseguito il bloc- 
co di istruzioni. Quando tutti gli 
elementi della collezione sono stati 
assegnati a VariabileOggetto, il ci- 
clo For Each termina e il controllo 
passa all'istruzione successiva al- 
l'istruzione Next. 
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CREARE L'ISTANZA 
DELLA VARIABILE 
OGGETTO 

Dopo aver definito la variabile collezione, come ogni 
variabile oggetto, si deve creare un'istanza della va- 
riabile di tipo Hashtable. Il posto migliore in cui 
creare l'istanza della variabile oggetto mCol è nel co- 
struttore della classe. Il costruttore è un metodo ri- 
chiamato automaticamente ogni volta che viene 
creata un'istanza di un oggetto, in particolare è una 
specifica routine Sub il cui nome deve obbligatoria- 
mente essere New. Possiamo quindi scrivere: 

Public Sub New() 

'crea l'oggetto di tipo Hashtable 

mcol = New Hashtable() 
End Sub 



A questo punto avremo a disposizione una classe 



che crea una collezione privata. Perché questa clas- 
se sia di effettivo interesse si devono aggiungere i 
metodi che permettano di manipolare la collezione 
privata. In particolare gli elementi di una collezione 
sono aggiunti con il metodo Add e rimossi con il me- 
todo Remove. Uno specifico elemento della collezio- 
ne può essere referenziato con il metodo Item. 
Inoltre la proprietà Count restituisce il numero di 
membri della collezione. Analizziamoli in dettaglio. 



METODO ADD 

Poiché la variabile di tipo Hashtable, è stata dichia- 
rata come variabile privata della classe, non è possi- 
bile aggiungere oggetti alla collezione da un punto 
qualsiasi dell'applicazione. Per questo motivo si de- 
ve definire un metodo pubblico Add usando una 
procedura Sub pubblica che sfrutti il metodo Add 



DISEGNIAMO L'INTERFACCIA UTENTE 
DELL' APPLICAZIONE VIDEOTECA 



Nel numero precedente di ioProgrammo 
abbiamo iniziato la costruzione di un 
progetto per la gestione di una videoteca. 
In questo numero sfrutteremo le cono- 
scenze acquisite sulle collection per ren- 
dere più semplice la programmazione. 
Per quelli che non hanno seguito il nume- 
ro precedente riassumiamo brevemente i 
passi per la creazione dell'interfaccia 
utente. Prevediamo un tasto "nuovo" per 
inserire un nuovo film, una dialog per 
inserire i dati, un tasto salva per salvare 
fisicamente i dati delll' applicazione 
amento dell'applicazione. Tutto si può 
riassumere con i passi illustrati in questa 
procedura guidata. 
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H Selezioniamo il primo Button , evi- 
denziamo la proprietà Name per 
cambiare il nome in: ButtonNuovo. 
Evidenziamo la proprietà Text e 
cambiamo il testo in Nuovo. Facciamo lo 
stesso con gli altri variando la proprietà 
Name in: ButtonSalva, ButtonCancella e 
le proprietà Text a Salva e Cancella. 
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Q Selezioniamo la finestra FormVi- 
deoteca realizzata nell'articolo pre- 
cedente che contiene i seguenti controlli: 
IN. 4 TextBox dal nome: TextBoxTitolo, 
TextBoxGenere, TextBoxCosto, TextBox- 
Giorni. N. 4 Label con la descrizione dei 
TextBox corrispondenti. N. 1 controllo 
Button dal nome: ButtonMostraDati. 
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□ Selezioniamo un controllo ListBox 
dalla casella degli strumenti e 
disegniamolo sulla form. 
Lo utilizzeremo per contenere l'elenco di 
tutti i film presenti nella videoteca. 
Chiaramente più avanti illustreremo il 
codice necessario ad inserire o 
rimuovere un film da questo controllo 







: 


" 


^VVTl 








SI l: a S! Bl « * . 




f 




-■ 




m ■ m sia 






~ SOHH 




i™ 


□ HM 

9 Manto 




-?--■"■• - ■■■■■ S .. ti- 




Uh IH e 


::r r 


B 




Ì~„. ^ 




If™„ 






=_.._„, 

















Q Selezioniamo per tre volte un 
controllo Button dalla casella degli 
strumenti (nella sezione Windows Form) 
e disegniamo i tre controlli sulla form. 
Utilizzeremo questi bottoni per gestire 
le varie azioni corrispondenti a "nuovo", 
"inserisci", "salva" e che rappresentano 
il cuore dell'applicazione 
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Selezioniamo il controllo ListBox e, 
KM dalla finestra delle proprietà, 
modifichiamo la proprietà Name in: 
ListBoxFilm. Chiaramente da questo 
momento in poi ogni riferimento a 
questo controllo potrà essere effettuato 
utilizzando il suo nome, così come lo 
abbiamo settato nelle proprietà 
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nativo della collezione Hashtable. Il metodo Add na- 
tivo della collezione Hashtable, consente di aggiun- 
gere alla collezione un oggetto con la chiave ed il 
valore specificato. Per il nostro esempio si può utiliz- 
zare il titolo del film come chiave univoca per l'indi- 
viduazione di un generico oggetto Film. 

Public Sub Add(ByVal obj As film) 
'viene chiamato il metodo nativo Add della Hashtable 
'passandogli come parametri la chiave di accesso 
'e l'oggetto che dovrà contenere 
mcol.Add(obj.Titolo, obj) 



End Sub 



IL METODO REMOVE 

Per esporre l'opportunità di rimuovere un oggetto 
dalla collezione, si deve definire un metodo involu- 
cro Remove pubblico che sfrutti il metodo Remove 
nativo. 

Public Sub Remove(ByVal Chiave As String) 

'Utilizzata per rimuovere un elemento dalla collezione, 
'in base alla chiave dell'oggetto 
mcol.Remove(Chiave) 
End Sub 



Il metodo Remove nativo elimina dalla collezione 
l'oggetto che è stato aggiunto con la chiave passata 
come argomento. Se la chiave specificata non viene 
trovata nella collezione, VB genera un errore di Run- 
Time. È possibile migliorare metodo introducendo 
un gestore di eccezioni che eviti questo errore. 



IL METODO ITEM 

Il metodo involucro Rem permette di referenziare 
un elemento specifico della collezione. Per definire il 
metodo pubblico Rem si utilizza una Property Get a 
sola lettura che restituisce il riferimento ad uno spe- 
cifico oggetto della collezione individuato dal para- 
metro Chiave. 

Default Public ReadOnly Property Item(ByVal Chiave 

As String) As film 
Get 

'Utilizzato per fare riferimento ad un elemento 

della collezione, 
'con la Chiave passata come parametro 
Return mcol.Item(chiave) 
End Get 
End Property 



La proprietà Rem può diventare la proprietà prede- 
finita (si può definire soltanto una proprietà all'in- 
terno di una classe come default), utilizzando nella 



sua dichiarazione la parola chiave Default. In questo 
modo, nel momento in cui all'interno del codice si 
vorrà fare riferimento ad un oggetto della collezione, 
si potrà omettere la chiamata a questa proprietà. 
Dopo aver referenziato lo specifico oggetto della col- 
lezione, ed aver assegnato il riferimento ad una va- 
riabile oggetto, sarà possibile accedere alle proprietà 
ed ai metodi dell'oggetto restituito. 



LA PROPRIETÀ COUNT 

La proprietà Count dovrà restituire il numero di ele- 
menti presentì nella collezione. Per implementarla 
si deve definire una proprietà pubblica a sola lettura 
che chiami la proprietà intrinseca Count della colle- 
zione Hashtable 

Public ReadOnly Property Count() As Integer 

Get 

Return mcol. Count 

End Get 
End Property 



GLI ELEMENTI 

DI UNA COLLEZIONE 

I metodi e le proprietà definiti finora rappresentano 
il set minimale che una collezione deve implemen- 
tare, per migliorare la vita al programmatore si può 
pensare a un metodo che consenta di navigare facil- 
mente tra gli oggetti di una collezione: il metodo 
Elements. Il metodo Elements dovrà restituire un 
enumeratore, cioè un oggetto che scorre l'insieme 
associato. L' enumeratore è simile ad un puntatore 
che si sposta su qualsiasi elemento dell'insieme, e 
viene utilizzato nell'istruzione ForEach.. Next. 
L'interfaccia ICollection fornisce il suo enumeratore, 
pertanto si può scrivere: 



Public ReadOnly Property 


Elements() 


As ICollection 


Get 


Return 


mcol.Values 






End Get 


End Property 



L'APPLICAZIONE 
VIDEOTECA 

Per inserire i dati di un nuovo film, il gestore della 
videoteca dovrà: 

• Premereil tasto Nuovo. 

• Inserire i dati del film nei TextBox Corrispon- 
denti. 




Quando si aggiunge un 
oggetto alla collezio- 
ne, esso non viene 
realmente aggiunto 
alla collezione, piutto- 
sto viene aggiunto alla 
collezione un riferi- 
mento all'oggetto. Una 
collezione contenente 
un insieme di oggetti 
contiene, quindi, in 
realtà un insieme di 
riferimenti ad oggetti. 
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COSTRUTTORI 

Un aspetto molto im- 
portante della proget- 
tazione di oggetti è il 
concetto di costrutto- 
re. Il costruttore è una 
porzione di codice di 
inizializzazione esegui- 
to ogni volta che viene 
creata un'istanza di un 
oggetto. Tipiche opera- 
zioni d'inizializzazione 
sono: l'apertura di file, 
la connessione ad un 
database, o più sempli- 
cemente l'impostazio- 
ne di valori predefiniti 
per le proprietà di un 
oggetto. 
Per creare un costrut- 
tore, si deve scrivere 
una procedura denomi- 
nata Sub New in un 
qualsiasi punto del 
codice della classe. Il 
codice del metodo Sub 
New viene eseguito 
prima del resto del 
codice della classe. Se 
non si definisce in 
modo esplicito una 
Sub New, VB .NET crea 
in modo implicito, in 
fase di esecuzione, un 
costruttore Sub New. 



• Premere il tasto Salva per inserire il film nella 
lista della videoteca. 

Analizziamo il codice necessario al funzionamento 
dell'applicazione. 

'Definizione delle variabili globali 
Dim CollezioneDiFilm As ColFilm 
Dim ObjFilm As film 

La variabile oggetto CollezioneDiFilmrappresenta 
una istanza della classe ColFilm, che dovrà contene- 
re per la durata dell'applicazione l'insieme dei film 
della videoteca. La variabile oggetto ObjFilm rappre- 
senta una istanza della classe Film, che dovrà conte- 
nere i dati del film corrente. 



INIZIALIZZARE 

LA CLASSE COLLEZIONE 

Il ciclo di vita dell'oggetto CollezioneDiFilmcoincide 
con il ciclo di vita della form per questo motivo la 
variabile oggetto CollezioneDiFilmdovrà essere 
creata nell'evento Load della form 

Private Sub FormVideoteca_Load(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles MyBase.Load 
CollezioneDiFilm = New ColFilm 
End Sub 



IL PULSANTE NUOVO 

Per inserire un nuovo film nella videoteca, la prima 
operazione che dovrà compiere l'utente sarà di pre- 
mere il pulsante nuovo. Nell'evento click di Button- 
Nuovo dovremo, quindi, preoccuparci di svuotare i 
TextBox e di creare la variabile oggetto ObjFilm con 
la sintassi ormai nota: 

Private Sub ButtonNuovo_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles ButtonNuovo. Click 
ObjFilm = New film 
SvuotaCampi() 
End Sub 



LA PROCEDURA 
SVUOTACAMPI 

La procedura per pulire i campi non dovrà fare altro 
che porre la proprietà Text dei quattro TextBox pari 
alla stringa vuota. Per questo possiamo scrivere: 

Private Sub SvuotaCampi() 



TextBoxTitolo.Text = "" 


TextBoxGenere.Text = "" 


TextBoxCosto.Text = "" 


TextBoxGiorni.Text = "" 


End Sub 



IL PULSANTE SALVA 

Quando l'utente completa l'inserimento dei dati, 
dovrà premere il tasto salva per inserire il film nella 
lista dei film della videoteca. 

Private Sub ButtonSalva_Click(ByVal sender As 
System. Object, ByVal e As System. EventArgs) 

Handles ButtonSalva. Click 
'controllo sull'esistenza dell'oggetto ObjFilm 
If ObjFilm Is Nothing Then 

MessageBox.Show("Si deve prima premere il 

tasto Nuovo") 
Exit Sub 



End If 



ValorizzaCampi() 



Try 



CollezioneDiFilm. Add(ObjFilm) 



Catch 



End Try 



VisualizzaLista() 



SvuotaCampifJ 



ObjFilm = Nothing 



End Sub 

La prima istruzione controlla se l'oggetto ObjFilm è 
stato creato. In caso contrario avvisa l'utente che 
prima di inserire i dati di un nuovo film si deve pre- 
mere il tasto Nuovo, e forza l'uscita dalla procedura. 
La procedura ValorizzaCampi dovrà assegnare i 
valori inseriti nei tre TextBox alle proprietà dell'og- 
getto ObjFilm. 



INSERIRE IL FILM 
NELLA COLLEZIONE 

L'istruzione: CollezioneDiFilm Add (ObjFilm), inseri- 
sce il film corrente nella collezione dei film della vi- 
deoteca. L'istruzione è preceduta dal gestore di ecce- 
zioni Try.. Catch.. End Try, che analizzeremo meglio 
in uno dei prossimi articoli. Ci basti sapere che in 
questa forma, cattura l'errore e passa all'istruzione 
successiva ad End Try nel caso in cui si tenta di inse- 
rire nella collezione un film con lo stesso titolo di un 
film già presente nella videoteca. Utilizzando l'istru- 
zione Try.. Catch.. End Try in questa forma, si potrà 
usare il tasto Salva finanche per modificare i dati di 
un film selezionato tra la lista dei film della videote- 
ca. Infine la procedura VisualizzaLista dovrà visua- 
lizzare nel ListBox il film appena inserito. 
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LA PROCEDURA 
VISUALIZZALISTA 

Private Sub VisualizzaListaQ 

Dim tmpFilm As New film 

ListBoxFilm.Items.Clear() 

For Each tmpFilm In CollezioneDiFilm.Elements 
ListBoxFilm.Items.Add(tmpFilm. Titolo) 

Next 
End Sub 



La variabile locale tmpFilm, ci permetterà di ciclare 
tra tutti i film della videoteca, referenziando volta 
per volta un oggetto film diverso. La successiva 
istruzione svuota il ListBox per mezzo del metodo 
Clear dell'insieme Items. Utilizzando l'istruzione For 
Each. . . Next è possibile ciclare su ogni film della col- 
lezione, ed aggiungere il titolo del film nel ListBox, 
tramite la proprietà Add dell'insieme Items. Questa 
procedura può essere resa più performante poiché, 
come possiamo facilmente notare, ogni volta che 
l'utente preme il tasto Salva per inserire un nuovo 
film, la lista viene prima svuotata e poi riempita ri- 
dando su tutti i film della collezione. Per una video- 
teca poco fornita può andare bene così. 



LA PROCEDURA 
VALORIZZACAMPI 

La procedura ValorizzaCampi dovrà assegnare i va- 
lori inseriti nei tre TextBox alle proprietà dell'ogget- 
to ObjFilm. Il codice sarà semplicemente: 

Private Sub ValorizzaCampi() 

ObjFilm. Titolo = TextBoxTitolo.Text 
ObjFilm. Genere = TextBoxGenere.Text 
ObjFilm. Costo = CDec(TextBoxCosto.Text) 

End Sub 



MODIFICARE 

I DATI DI UHI FILM 

L'ultima funzionalità che ci resta da implementare è 
la possibilità di modificare i dati di un film presente 
nella lista (doppio click sul ListBox). Per ottenere 
questo scopo, l'utente dovrà selezionare il film dalla 
lista, modificare eventualmente i suoi dati e preme- 
re il tasto Salva per visualizzare i nuovi dati nella 
lista. Nell'evento DoubleClick del ListBox scriviamo: 

Private Sub ListBoxFilm_DoubleClick(ByVal sender As 
Object, ByVal e As System. EventArgs) Handles 
ListBoxFilm. DoubleClick 
' Verifica che sia stato selezionato un film. 

If ListBoxFilm. Selectedltem <> "" Then 
ObjFilm = CollezioneDiFilm( 



ListBoxFilm. Selectedltem) 



VisualizzaDati() 



End If 



End Sub 

Tramite la proprietà Selectedltem del ListBox, pos- 
siamo accedere all'elemento selezionato nella lista, 
per questo se l'elemento selezionato è diverso dalla 
stringa vuota si può procedere con l'esecuzione del 
codice in caso contrario la procedura termina senza 
nessun effetto. All'interno del blocco If. Then..End If 
viene valorizzato l'oggetto ObjFilmcon un riferi- 
mento all'elemento della collezione che ha come 
chiave il titolo selezionato nel ListBox e ne vengono 
mostrati i dati. 



LA PROCEDURA 
VISUALIZZADATI 

La procedura VisualizzaDati deve visualizzare nei 
TextBox corrispondenti, i dati del film selezionato: 

Private Sub VisualizzaDati() 

TextBoxTitolo.Text() = ObjFilm. Titolo 
TextBoxGenere.Text = ObjFilm. Genere 
TextBoxCosto.Text = ObjFilm. Costo 

End Sub 



Vi lascio, infine, il compito di scrivere il codice asso- 
ciato al tasto Cancella che dovrà cancellare un ele- 
mento dalla collezione e dal ListBox, confrontatelo 
poi con il codice riportato nel box 
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Fig. 1: L'applicazione Videoteca in esecuzione 



CONCLUSIONI 

Se vi piace un software ben progettato, sarete certa- 
mente d'accordo che la programmazione ad ogget- 
ti è una tecnologia attraente. Parlando di VB.NET 
utilizzeremo spesso i concetti e la terminologia usa- 
ta in questa serie, poiché tutti i controlli in sono 
degli oggetti, e molti di essi presentano al loro inter- 
no una collezione di oggetti. 

Luigi Buono 




DISTRUTTORI 

Il distruttore è una 
porzione di codice per 
il rilascio delle risorse 
di sistema eseguito 
ogni volta che si rila- 
scia il riferimento ad 
un oggetto. Tipiche 
operazioni di rilascio 
delle risorse di sistema 
sono: la chiusura di un 
file, la chiusura di una 
connessione a databa- 
se o il salvataggio di 
informazioni di stato. 
Prima di distruggere 
un oggetto, il compila- 
tore chiama automati- 
camente il metodo 
Finalize per oggetti 
che definiscono una 
routine Sub Finalize. 
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Costruire user 
control con ASP.NET 

I custom control consentono di creare oggetti che favoriscono 
il riutilizzo del codice e facilitano la scrittura delle applicazioni. 
È una tecnica basilare per creare software dai lavori precedenti 
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Il riutilizzo del codice è uno dei fondamenti 
su cui l'object oriented programming si 
basa. Poter riutilizzare qualcosa in più punti 
dell'applicazione, specie in ambito web, consen- 
te di risparmiare tempo, perché una volta scritto 
il codice, si può riutilizzare ed impiegare quel 
tempo per qualcosa di meglio. In secondo luogo, 
consente di scrivere meno codice, con il conse- 
guente vantaggio di esser certi di introdurre 
meno bug e soprattutto di potersi concentrare in 
un solo punto qualora siano necessarie modifi- 
che, anche sostanziali. Infine, centralizzare in un 
solo punto le funzionalità, diventa anche un van- 
taggio in fase di manutenzione ordinaria, perché 
è più facile trovare il posto in cui una data fun- 
zionalità è stata inserita. 



su più progetti, di un custom control. Infine, 
mentre i primi sono compilati in class libray, i 
secondi sono dei file con HTML e codice mi- 
schiato, dall'estensione .ascx. 
Concettualmente, dunque, gli user control ricor- 
dano molto da vicino gli include, utilizzati ad 
esempio con Classic ASP per la costruzione dei 
template, piuttosto che per includere all'interno 
di più pagine le stesse funzionalità. In realtà, a 
differenza di un include, uno user control è un 
oggetto a tutti gli effetti e dunque può essere pro- 
grammato, prima di tutto. 

Questo vuol dire, molto semplicemente, che si 
hanno a disposizione proprietà, metodi ed even- 
ti all'interno di questo oggetto, e che è possibile 
dal contenitore (che in genere è la pagina) modi- 
ficarne lo stato. 
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REQUISITI 



HM.W1.UM 
Imi HTML, ASP.NET 



, Microsoft .NET 
Framework 1.0 o 
successivi, ASP.NET 




RIUTILIZZARE 

IL CODICE COM ASP.NET 

ASP.NET consente due modalità principali per 
riutilizzare il codice, dove per questo si intende- 
rà, d'ora in poi, una certa funzionalità ed il codi- 
ce (X)HTML associato: 

• Custom control: sono classi vere e proprie, 
che ereditano da Control (o da un altro con- 
trollo di ASP.NET) e sono principalmente 
composte da codice C# (oVB.NET); 

• User control: sono pezzi di pagina, composti 
più da HTML che da codice vero e proprio. 

I vantaggi dell'uno o dell'altro approccio sono 
evidenti e consistono principalmente nell'es- 
sere utili in scenari diversi. I custom controls, 
per esempio, sono la scelta obbligata quando 
un control è molto complesso oppure, più 
semplicemente, va distribuito su più progetti. 
Gli user control, dal canto loro, sono molto 
immediati e si realizzano molto semplice- 
mente, ma sono sicuramente meno portabili, 



ANATOMIA 

DI UNO USER CONTROL 

Per capire al meglio come sfruttare uno user 
control, è necessario capirne prima di tutto la 
struttura. Per prima cosa, possiamo vederlo 
come una normale pagina. La differenza è che 
in realtà, a differenza della pagina, è solamente 
un pezzo di questa, e non è detto che sia auto- 
sufficiente, in quanto a funzionalità. Se provate 
a creare uno user control conVS.NET, noterete 
che rispetto alla pagina, la classe da cui eredita 
è UserControl, contenuta sempre nel na- 
mespace System. Web.UI. È tuttavia possibile 
scrivere, proprio come nel caso delle pagine, 
oggetti che contengano il codice direttamente 
nel corpo, utilizzando la tecnica nota come 
code inline. 

Dunque, proprio come in una pagina, abbiamo 
a disposizione gli eventi della stessa, come Pa- 
ge_Load. In più, uno user control è inserito 
nella pagina proprio come un normale server 
control, attraverso una sintassi del tipo: 
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<ioprogrammo:news runat="server" id = "news" /> 

Evidentemente c'è qualcos'altro dietro che al 
momento ignoriamo e che in seguito lo affronte- 
remo. Ma come si può notare, non si tratta di un 
semplice include, bensì di un oggetto vero e pro- 
prio che quindi possiamo creare, in modo da 
essere completamente programmabile dall'og- 
getto contenitore. 



IL MOSTRO PRIMO 
USER CONTROL 

Per capire meglio la potenza e la flessibilità che 
questi oggetti offrono allo sviluppatore, vediamo 
come crearne uno semplice, che ci consenta di 
toccarne con mano i vantaggi. Per questo primo 
test creeremo un semplice user control che mo- 
stra a video, stampata, la data attuale. Per prima 
cosa, dunque, definiamone la struttura: 

<%@Control Language="C#"%> 
<p>Data attuale: <asp:literal id = "data" 

runat="server" /></p> 

Successivamente aggiungiamone il codice: 

void Page_Load() 

{data.Text = DateTime.Now.ToLongDateString();} 

Creiamo una semplice pagina, ed inseriamo in 
cima alla stessa: 

<%@ Register TagPrefix="ioprogrammo" 

TagName="Data" Src="testl.ascx" %> 

Quindi nel punto in cui vogliamo che la data ven- 
ga inserita: 

<ioprogrammo:Data runat= "server" /> 

Possiamo anche includerne più di uno per pagi- 
na, senza dover replicare il codice. Tra l'altro, il 
vantaggio di usare gli user control è che possono 
essere anche scritti in un linguaggio differente da 
quello della pagina, ammesso che questo abbia 
senso per quanto riguarda la coerenza dell'appli- 
cazione. 



REGISTRARE 

UNO USER CONTROL 

L'abbiamo appena fatto in maniere empirica, ma 
vale la pena soffermarsi un attimo sul funziona- 
mento della registrazione. Nell'esempio prece- 
dente abbiamo inserito una riga in alto, nella pa- 



gina contenitore. È un'istruzione obbligatoria 
che serve a dire al parser di ASP.NET dove andare 
a recuperare il codice sorgente dello user control. 
Si tratta di un codice che ha questa forma: 

<%@ Register TagPrefix="prefix" TagName="name" 

Src="file.ascx" %> 

Ed i cui valori hanno esattamente questo signifi- 
cato quando andiamo ad inserire il control nella 
pagina: 

<prefix:name runat="server" /> 

L'attributo Sic è invece riferito al path per arriva- 
re al file sorgente e può essere un percorso relati- 
vo piuttosto che uno assoluto, ma ovviamente 
deve sempre puntare ad una risorsa raggiungibi- 
le localmente. La prima riga va inserita ogni volta 
che dobbiamo usare uno user control all'interno 
di una pagina ed è tutto quello di cui abbiamo bi- 
sogno per poter poi inserire il control. 



COMUNICARE 
CON LA PAGINA 

Creato il primo control, dobbiamo ovviamente 
porci il problema di come farlo comunicare con 
il resto del mondo, che per noi sono gli altri sog- 
getti presenti sulla pagina. Uno user control, in- 
fatti, può essere contenuto all'interno di una pa- 
gina ma anche all'interno di un altro user con- 
trol, dunque di fatto non è detto che l'oggetto 
contenitore sia a propria volta un altro control di 
questo tipo, anzi spesso è proprio così. Dunque 
in questo frangente, per semplicità, ci riferiremo 
sempre all'argomento specificando come ogget- 
to contenitore una pagina, ma i concetti sono del 
tutto identici qualora il contenitore sia un altro 
user control. L'esempio che abbiamo appena vi- 
sto, nella sua banalità, ci permette comunque di 
capire che, in fin dei conti, uno user control è un 
qualsiasi oggetto e quindi pertanto può essere 
esteso. A questo proposito, vediamo come ag- 
giungere al nostro control una serie di proprietà 
per far sì che l'aspetto grafico dello stesso sia più 
gradevole. Cominciamo con il dotare il nostro 
oggetto di una proprietà di testo di nome Css- 
Class, che useremo per specificare uno stile da 
associare al testo scritto: 

// proprietà per specificare uno stile 
private string cssClass; 
public string CssClass 
{ get {return cssClass;} 
set {cssClass = value;} 
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Continuiamo le modifiche associando questo va- 
lore alla rispettiva proprietà di un panel all'inter- 
no del quale avremo rinchiuso il testo già presen- 
te sul control. Ovviamente dovremo specificare, 
nella pagina, il valore da associare a questa pro- 
prietà. Possiamo farlo semplicemente in questo 
modo: 

<ioprogrammo:Data ìd="datal" runat="server" 

CssClass= "date"/> 

Facciamo la stessa modifica per poter specificare 
un testo alternativo, da associare ad un control 
Literal inserito sul controllo, da visualizzare pri- 
ma della data: 

// proprietà per specificare un testo di descrizione 
private string text = "Data attuale:"; 
public string Text 



{ get {return text;} 



set {text = value;} 



} 



Come si può notare, in questo caso abbiamo as- 
sociato un valore di default alla variabile privata 
che internamente la nostra classe utilizza per la 
persistenza del dato. È una pratica molto diffusa 
quando si realizzano controls, perché consente 
di rendere meno impegnativa la definizione delle 
proprietà necessarie al funzionamento del con- 
trol, ma al tempo stesso consente di arrivare ad 
avere una personalizzazione completa. Conclu- 
de il nostro control la definizione di un evento 
sul Page_Load, che vada a formattare gli oggetti 
della pagina con le proprietà specificate: 

void Page_Load() 
{ testo. Text = Text; 

data. Text = DateTime.Now.ToLongDateString(); 

if (cssClass != nuli) 

contenitore. CssClass = cssClass; 



MANTENERE LO STATO: 
IL VIEWSTATE 

Provate ad assegnare le proprietà attraverso co- 
dice e noterete che, tra i vari PostBack, i valori 
non vengono mantenuti e che, soprattutto, gli 
eventi si verificano, nella pagina e nei controls, 
secondo modalità differenti. Quest'ultimo aspet- 
to è approfondito nel box laterale. Per quanto ri- 
guarda il primo problema, è essenzialmente do- 
vuto al fatto che tutti i controls che usiamo sulle 
pagine mantengono il loro stato attraverso il 
ViewState, di cui abbiamo già parlato in uno dei 
precedenti articoli. Dunque per fare in modo che 



il nostro control mantenga lo stato delle proprie- 
tà tra i vari PostBack, dovremo fare una modifica 
che consenta di salvare e leggere il valore di que- 
ste proprietà da questo state bag. La proprietà 
CssClass, usata per specificare uno stile, diventa: 

// proprietà per specificare uno stile 
private string cssClass; 
public string CssClass 



{ // leggiamo dal ViewState 



get {return ViewState["data_cssClass"] as String;} 



// scriviamo nel ViewState 



set { 



ViewState["data_cssClass"] = value; 



cssClass = value; } 



} 



E la proprietà Text segue la stessa strada appena 
spiegata, ovviamente. Come si può notare, nel 
recuperare la proprietà andiamo in realtà a leg- 
gere direttamente dal ViewState, dato che in fase 
di assegnazione ne abbiamo salvato il valore. 
L'ultima modifica poi, riguarda il momento in 
cui applicare le proprietà al control. Tra gli even- 
ti a disposizione per chi sviluppa controls, quel- 
lo che sicuramente rappresenta il momento mi- 
gliore in cui andare ad applicare eventuali pro- 
prietà di tipo "grafico " è Page_PreRender, che si 
verifica dopo Page_Init e Page_Load e prima 
che la pagina venga costruita per essere inviata al 
client. Dunque sposteremo tutta la logica in que- 
sto evento, in modo che sia possibile effettuare 
tutte le operazioni quando il ViewState è stato 
già caricato. A questo proposito, andremo ad ag- 
giungere un pulsante nella pagina ASP.NET alla 
cui pressione lo stile associato al nostro user 
control sarà modificato: 



void cambia(Object o. 


EventArgs e) 


{ 


Trace. Write(datal. CssClass); 




if (datai. CssClass 


== "date") 




datai. CssClass = 


"datedark"; 


else 




datai. CssClass 


= "date"; 


} 



Dopo questa ultima modifica siamo pronti per 
poter costruire control decisamente più avanzati. 



UNO USER CONTROL 
PER L'ACCESSO Al DATI 

Uno scenario in cui spesso uno user control può 
tornare utile è la definizione di una griglia per la 
visualizzazione dei dati, che includa funzionalità 
che sono ripetute più di una volta all'interno del- 
la nostra applicazione. In particolare, l'esempio 
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che prenderemo in considerazione si basa su 
uno user control contenente un DataGrid che 
mostra dati prelevati da un database, come ab- 
biamo imparato a fare nel numero precedente. 
In più in questo caso abbiamo aggiunto la possi- 
bilità di visualizzare in automatico un messaggio 
qualora l'estrazione non dovesse produrre risul- 
tati, caratteristica molto utile ma che di default il 
DataGrid non fornisce. Partiamo dunque con il 
creare lo user control, definendo due proprietà 
pubbliche, una di nome DataSource per specifi- 
care la sorgente dati, ed una di nome NoRecord- 
Text per associare un testo alternativo al messag- 
gio che appare quando non ci sono record: 

// proprietà per specificare un DataSource 
private object dataSource; 
public Object DataSource 



{ // leggiamo dal VìewState 



get {return ViewState["data_dataSource"];} 



// scriviamo nel ViewState 



set { ViewState["data_datasSource" 



va lue; 



dataSource = value; } 



} 



Dobbiamo usare come tipo Object perché è pos- 
sibile fare il binding ad una DataGrid di un nu- 
mero molto elevato di oggetti, inclusi quelli per- 
sonalizzati. Inseriamo quindi nel control un Da- 
taGrid con ID "dg" ed inseriamo nell'evento Pa- 
ge_PreRender il codice necessario ad associare 
la fonte dati al nostro DataGrid ed al tempo stes- 
so a visualizzare un messaggio di errore in caso di 
mancanza di record: 

void Page_PreRender() 
{ bool hasRows = false; 

// associo il dataSource al controllo 
if (dataSource != nuli) 
{ dg. DataSource = dataSource; 
dg.DataBind(); 
// ci sono record? 
hasRows = (dg.Items.Count>0); } 
if (! hasRows) 

{ // avvisiamo che non ci sono record 
this. Controls. Add(new LiteralControl( 

noRecordText)); 
// nascondiamo controllo 
dg.Visible = false; } 
} 



Nella pagina andiamo a registrare il control ap- 
pena creato, lo inseriamo all'interno della web 
form insieme ad un pulsante ed effettuiamo il 
binding dei dati attraverso questa funzione: 

// carico i dati 

void bindData(string filtro) 



{ [■■■] 


// creo il dataset 


e lo riempio 


con 


dati 


DataSet ds = new DataSet(); 


query.Fill(ds); 


// associo i dati e 


1 nostro user 


control 


dg. DataSource = 


ds; 






} 



Al pulsante invece assoceremo questo event 
handler: 



void filtro(Object o. 


EventArgs 


e) 


{ 


// filtro la griglia 








bindDatafWHERE title_id = 


'1'"); 


} 



Come si può notare dalle immagini, nel primo 
caso verrà mostrata la griglia, nel secondo provo- 
cando un'associazione che non restituisce re- 
cord, verrà visualizzato il nostro messaggio. 



CONCLUSIONI 

Costruire oggetti programmabili e riutilizzabili 
con ASP.NET è davvero molto semplice. L'argo- 
mento user control può sembrare banale, ma in 
realtà è uno dei punti di forza che un'applicazio- 
ne web è in grado di sfruttare al meglio, poiché 
consente di riutilizzare molto codice, ma soprat- 
tutto di modellare gli oggetti in base alle proprie 
necessità. 

Daniele Bochicchio 



LA SEQUENZA DEGLI EVENTI 
TRA PAGINA E CONTROLS 




Sia la pagina, che eredita dalla clas- 
se Page, sia gli user controis, che 
ereditano invece da UserControl, 
hanno una serie di eventi in comu- 
ne che servono per eseguire codice 
in base al verificarsi di determinate 
condizioni. È importante conoscere, 
in applicazioni complesse, il giusto 
ordine in cui si verificano questi 
eventi all'interno dei controis. In 
tutto ci sono 9 eventi, tra cui sicura- 
mente i più utilizzati, in ordine di 
successione, sono: 

• Pagejnit 

• Page Load 

• Page_PreRender 

• Page Render 

Se una pagina contiene uno user 
control, quest'ultimo avrà la stessa 
sequenza di eventi della pagina, 
con la differenza che ogni evento 
sarà invocato subito dopo l'evento 
corrispondente contenuto nella pa- 



gina. In pratica, la sequenza sarà la 
seguente: 

• Pagejnit 

* Della pagina 

- Degli user Controls 

• Page Load 

* Della pagina 

- Degli user Controls 

• Page PreRender 

* Della pagina 

- Degli user Controls 

• Page Render 

* Della pagina 

- Degli user Controls 

Se ad esempio dobbiamo passare, 
da uno user control, informazioni 
che la pagina dovrà leggere nell'e- 
vento Page Load, dovremo scrivere 
il codice all'interno del Page_ Init. 
Analogamente, se uno user control 
è contenuto in un altro user con- 
trol, questi eventi si verificheranno 
sempre nel control contenitore. 
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Javascript 




L'URL che non 
ti fa "arrabbiare" 

Utilizzare correttamente gli URL è l'unico metodo per scrivere 

applicazioni WEB in grado di gestire correttamente le informazioni 

Ma cos'è un URL? Che c'entra JavaScript? Scopriamolo in questo articolo 




jn 




REQUISITI 



Conoscenze richieste 



i Basi di Javascript 

Bua 




Tempo di realizzazione 



Supponete di avere a disposizione un 
database di parole e di indirizzi internet. 
Voi siete proprietari di un sito internet 
un po' particolare. Il vostro sito propone una 
pagina che, dato un elenco alfabetico di paro- 
le, consente ad un utente di cliccare su una di 
queste e ottenere in risposta un elenco di siti 
che la contengono, con il relativo indirizzo. 
Per questioni di velocità non volete che la 
pagina sia ricaricata dopo ogni clic, ma utiliz- 
zate uno script JavaScript che scrive sulla 
pagina dinamicamente i link in corrispon- 
denza dell' OnClic. Tutto chiaro? 
Sembrerebbe tutto limpido come l'acqua di 
fonte, ed invece qui ci scappa l'inghippo! Ve- 
diamo quali sono le trappole che si nascon- 
dono dietro la stampa di URL a schermo tra- 
mite Javascript. Qualche semplice accorgi- 
mento ci aiuterà a non compiere errori. 



UM ESEMPIO PRATICO 

Consideriamo un URL formato in maniera un 
pò particolare ad esempio: 

http ://www. google. it/search?hl = it&q=javascript&btnG 
= Cerca +con+Google&meta = 

Se stampate a video questo URL tramite il 
seguente codice JavaScript 



var strStringaDaCercare = 


"Javascript" 






str = 


'<a href=\""; 








str + = 


encodeURI( 

"http://www. 


google. it/search?hl = 
+ strStringaDaCe 


= it&q=" 
rea re); 


str + = 


"\">Ricerca parola 


" + StrStringaDaCercare 
+ "</a>"; 


document.write (str); 
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Vi verrà presentato un classico URL da clicca- 
re. Se cliccate, si aprirà una pagina di "Goo- 
gle" con i risultati di una ricerca per la parola 
"Javascript". Ora non è il caso di entrare nel 
dettaglio dei meccanismi di Google ma in 
ogni caso nella formattazione del Link notate 
che dopo il parametro "q" c'è la parola "Ja- 
vascript". Richiamando l'Uri di Google con dei 
parametri opportuni si ottiene in restituzione 
la pagina in questione. Non è su questo punto 
che ci vogliamo concentrare, ma sui caratteri 
che vengono utilizzati nella generazione del 
Link, quindi smettetela di concentrarvi su 
Google e passiamo oltre. 
Non si sa mai cosa un utente potrebbe cer- 
care, quindi supponiamo che invece della pa- 
rola "Javascript" vogliate ricercare la frase 
"j@vascript è bello ? (ma sì che è bello!) ". Cambia- 
mo allora il valore della variabile strStringaDa- 
Cercare ottenendo il codice seguente: 

var StrStringaDaCercare = "j@vascript è bello ? 

(ma sì che è bello!)"; 
str = "<a href=\""; 
str += "http://www. google. it/search?hl = it&q = " + 

strStringaDaCercare; 
str += "\">Ricerca parola: " + StrStringaDaCercare 

+ "</a>"; 
document.write (str); 

Se clicchiamo sul link così generato, non otte- 
niamo il risultato sperato. Google, invece di 
cercare la stringa che gli abbiamo passato 
cercherà la seguente: "j@vascript ? bello ? (ma 
s? che ? bello!) " in cui i caratteri accentati sono 
stati sostituiti da ? (inseriti da Google per 
significare che il carattere "è" non è ricono- 
sciuto). Si sarà intuito che ovviamente l'erro- 
re non è di Google, ma è nostro, in quanto 
non abbiamo codificato il modo opportuno la 
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stringa inviata. 

Proviamo allora il seguente codice: 



var strStringaDaCercare = 


'j@vascript 
sì 


è bello ? (ma 
che è bello!)"; 


str = 


<a href=\""; 








str + = 


encodeURI("http://www 
/search?hl = it&q=" + 


google 
strStrir 


it 
gaDaCercare); 


str + = 


"\">Ricerca parola 


" + 


StrStringaDaCercare 
+ "</a>"; 


document.write (str); 



Questo spezzone di codice ha di diverso dal 
precedente il fatto che alla seconda linea è 
stato inserito la funzione encodeURU ) che 
codifica correttamente tutto il percorso del- 
l'ancora (che è a tutti gli effetti un indirizzo 
URI). Se ora proviamo il link così generato, 
abbiamo il risultato voluto (al di là del fatto 
che non si otterrà nulla nella pagina di ricer- 
ca, vista la stringa un po' assurda che si sta 
cercando...). Trucco svelato, articolo finito, 
andiamo tutti a provare il nostro giochino 
nuovo! E invece no, proviamo questa frase: 
"Paolo&Rossi Associated ". 
Il codice sarà il seguente: 

var StrStringaDaCercare = "Paolo&Rossi Associated"; 



str = "<a href=\" 



str += encodeURI("http://www. google.it 

/search?hl = it&q=" + StrStringaDaCercare); 



str += "\">Ricerca parola: 



+ StrStringaDaCercare 
+ "</a>" 



document.write (str); 

Cliccando sul link, invece di trovarci la pagina 
dei risultati per la stringa "Paolo&Rossi Associa- 
ted", troviamo i risultati della ricerca della sola 
parola Paolo. Dov'è che sbagliamo? Il fatto è 
che la stringa ricercata contiene il carattere 
"&"tra il nome 'Paolo' ed il nome 'Rossi' che ha 
un significato particolare per gli indirizzi URI 
(quello di concatenare le variabili passate in 
GET). Quindi non viene decodificato. 
Il codice corretto è il seguente: 

var strStringaDaCercare = "Paolo&Rossi Associated"; 

str = "<a href=\""; 

str += "http://www. google. it/search?hl = it&q = " 

+ encodeURIComponent(strStringaDaCercare); 



str += "\">Ricerca parola: 



+ StrStringaDaCercare 
+ "</a>" 



document.write (str); 



codificati utilizzando il metodo encodeURI- 
Component( ) che non permette dei caratteri, 
come "&", che sono permessi invece da 
encodeURI(). In articoli successivi, parlando di 
passaggio di dati mediante Javascript tra form 
HTML approfondiremo e generalizzeremo 
quanto discusso nel caso semplice di un uni- 
co parametro di ricerca (la cosa è leggermen- 
te più complessa...). Per adesso ricordatevi di 
fare sempre attenzione a usare correttamente 
i metodi, a secondo se si parla di URI o di sue 
componenti. 



COSA BOLLE 
SOTTO UHI URI 

Fin qui abbiamo spesso usato la parola URI. 
In letteratura URI vuol dire Uniform Resource 
Identifier. Si intende per URI un puntatore che 
identifica in modo univoco una risorsa pre- 
sente sulla rete. Un link è sicuramente un URI. 
Ora, il basamento di Internet è che tutti colo- 
ro che utilizzano questo mezzo come forma di 
diffusione dei contenuti o per un qualunque 
motivo, si devono adeguare a degli standard 
certi, di modo che ciascuno sia in grado di ac- 
cedere ad internet in modo uniforme. Imma- 
ginate cosa potrebbe succedere se il 10% dei 
siti internet identificassero i link nella forma 
"http((pippo;it))", invece che nella forma 
"http://pippo.it" a cui siamo abituati, e immagi- 
nate cosa succede se ognuno utilizzasse delle 
proprie regole per scrivere i link. Perciò si 
definiscono degli standard a cui tutti devono 
adeguarsi. Non si discosta da questa regola la 
definizione di un URI. La RFC 3986 sancisce 
che un URI deve essere così composto: 

scheme":" hier-parm ["?" query ]["#" fragmen] 

dove a sua volta hier-parm è composto di 

//Authorithy 
/Path-absolute 
/Path-rootless 
/Path-Empty 

Per farla breve, se 

scheme->http, authorithy-> www.google.it, query-> 

hl=it&q Javascript 

Il nostro URI avrebbe la forma 




UN PO' DI 

MATEMATICA... 

In termini matematici 
si potrebbe dire 
l'insieme è invariante 
per trasformazioni f : K 
-> K dove f è uno dei 
nostri metodi 
encodeURIO, 
encodellRIComponent( 
) oppure escape(), 
mentre K è l'insieme di 
caratteri che viene 
trasformato in se 
stesso. Ogni carattere 
che viene trasformato 
in se stesso, per un 
particolare metodo, è 
quindi un elemento 
dell'insieme invariante 
K di quel metodo. 
Nel seguito 
dell'articolo 
utilizzeremo il simbolo 
U nel senso 
insiemistica di unione 
di insiemi. La stringa: 
[A..Z]U[a..z]U[0..9]U[ * + 
- . / @ _] 

Sta quindi a significare 
l'insieme formato da 
tutti gli elementi [A..Z] 
più gli elementi [a..z] 
più ancora gli elementi 
[0..9] e [ * + - . / @ _]. 



Il valore contenuto in StrStringaDaCercare deve 
essere considerato un componente dell'URI e 
quindi tutti i caratteri in esso contenuti vanno 
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mo cercare la frase "Java è un linguaggio?" la 
nostra query assomiglierebbe a qualcosa del 
genere: 

http://www. google. it?hl = it&qJava è un linguaggio? 

Va da sé che questa formattazione non è cor- 
retta; primo perché ci sono degli spazi nella 
stringa da ricercare; secondo perché compare 
un punto interrogativo, al termine della frase 
che va in conflitto con la definizione di URI 
che prevede il punto interrogativo come sim- 
bolo per iniziare una query. Si evince da tutto 
ciò che esistono caratteri particolari che devo- 
no essere codificati prima di poter comparire 
all'interno di un URI. Ad esempio la codifica 
dello spazio bianco è %20 Esistono tre metodi 
con cui si può effettuare la codifica. E ciascu- 
no dei tre metodi stabilisce in che modo debba 
avvenire la codifica. Riassumendo, nella 
Tabella 1 per ogni metodo di codifica, è ripor- 
tato l'insieme di caratteri invariante sui quali il 
metodo non effettua alcuna codifica. 



(Metodo (f ) 


Insieme invariante ( K) 


\ 


encodeURI 


[A..Z]U[a..z]U[0..9]U[ !#$&'()* + ,-./:; 


= ?@_~] 


encode URIComponen t 


[A..Z]U[a..z]U[0..9]U[ !'()*-._-] 


escape(entità) 


[A..Z]U[a..z]U[0..9]U[ *+-./<§>_] 






I TUOI APPUNTI 



Utilizza questo spazio per 
le tue annotazioni 



uni pò 1 di Buoni 

VECCHIO CODICE 

Vediamo ora alcuni esempi pratici di applica- 
zione di questi metodi, verificando proprio 
l'invarianza di questi insiemi di caratteri. 
Definiamo le seguenti stringhe: 

// Definizione delle stringhe invarianti 

strllWComune = "ABCDEFGHIJKL MNOPQRSTUVWXYZ 
abcdefghijklmnopqrstuvwxyz0123456789"; 
strINVencodeURI = "!#$&'()*+, -./:;=?@_~"; 



strINVencodeURICmp 



'()*-■_- 



strINVescape 



*+-./<§> 



Per prima cosa verifichiamo che l'insieme di 
caratteri [A..Z] U [a..z] U [0..9] è un insieme 
invariante per trasformazione rispetto ai tre 
metodi. Il codice seguente: 

document.write("encodeURI(strINVComune) = " + 

encodeURI(strlNVComune) + "<br>"); 
document.write("encodeURIComponent(strINVComune) 
= " + encodeURIComponent(strllWComune) + "<br>"); 
document.write("escape(strINVComune) = " 

+ escape(strllWComune) + "<br>"); 



In output restituisce: 

encodeURI(strlNVComune) = ABCDEFGHIJKLMNOPQRS 
TUVWXYZabcdefghijklmnopqrstuvwxyz0123456789 

encodeURIComponent(strllWComune) = ABCDEFGHDK 

LMNOPQRSTUVWXYZabcdefghijklmnopq 

rstuvwxyz0123456789 

escape(strllWComune) = ABCDEFGHIJKLMNOPQRS 
TUVWXYZabcdefghijklmnopqrstuvwxyz0123456789 

Rispetto alle stringhe [A-Z],[a-z],[0-9] i tre me- 
todi si comportano allo stesso modo. 
Verifichiamo ora come si comportano questi 
tre diversi metodi sui tre gruppi di caratteri 
invarianti. Per quanto riguarda il metodo: 
encodeURI( ) il codice: 

document.write("encodeURI(strINVencodeURI) = " + 
encodeURI(strlNVencodeURI) + "<br>"); 
document.write("encodeURI(strINVencodeURICmp) = 
" + encodeURI(strlNVencodeURICmp) + "<br>"); 
document.write("encodeURI(strINVescape) = " + 

encodeURI(strlNVescape) + "<br>"); 

in output restituisce: 



encodeURI(strlNVencodeURI) = !#$&'()*+,-./:;=?<§>_ 
encodeURI(strlNVencodeURICmp) = !'()*-. _~ 
encodeURI(strlNVescape) = *+-./<§>_ 



Il risultato mostra proprio quanto ci si aspet- 
tava, e cioè che il metodo encodeURI( ) che 
possiede l'insieme invariante composto dal 
maggior numero di caratteri rispetto agli altri 
insiemi, non codifica nessuno dei caratteri 
degli altri insiemi. In pratica, l'insieme inva- 
riante per il metodo encodeURI( ) contiene i 
rimanenti due insiemi invarianti rispettiva- 
mente per i metodi encodeURIComponent( ) 
ed escape( ), che ne sono quindi sottoinsiemi. 
Per quanto riguarda il metodo: encodeURI- 
Component( ) il codice: 

document.write("encodeURIComponent(strINVencode 

URI) = " + encodeURIComponent( 

strINVencodeURI) + "<br>"); 

document.write("encodeURIComponent( 

strINVencodeURICmp) = " + encodeURIComponent( 

strINVencodeURICmp) + "<br>"); 

document.write("encodeURIComponent(strINVescape) 

= " + encodeURIComponent(strlNVescape) 

+ "<br>"); 

in output restituisce: 

encodeURIComponent(strlNVencodeURI) = 
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!%23%24%26'()*%2B%2C- 
.%2F%3A%3B%3D%3F%40_~ 



encodeURIComponent(strllWencodeURICmp) = !'()*-._~ 
encodeURIComponent(strlNVescape) = 

*%2B-.%2F%40_ 

Vediamo quindi che l'unico insieme di carat- 
teri invariante è [!'()*-._-], ossia quello che ab- 
biamo in precedenza definito essere invarian- 
te per il metodo encodeURIComponent( ). 
In modo del tutto analogo, per il metodo esca- 
pe () il codice: 

document.write("escape(strINVencodeURI) = " + 

escape(strlNVencodeURI) + "<br>"); 
document.write("escape(strINVencodeURICmp) = " + 
escape(strlNVencodeURICmp) + "<br>"); 
document.write("escape(strINVescape) = " + 

escape(strlNVescape) + "<br>"); 

produce in output: 

escape(strlNVencodeURI) = 

%21%23%24%26%27%28%29*+%2C- 
./%3A%3B%3D%3F@_%7E 
escape(strlNVencodeURICmp) = %21%27%28%29 

*-._%7E 
escape(strlNVescape) = *+-./<§>_ 

Anche per questo metodo valgono le conside- 
razioni fatte per encodeURIComponent( ) e ve- 
rifichiamo quindi che l'unico insieme di 
caratteri invariante è [* + -.l@ _j, ossia quello 
che abbiamo in precedenza definito essere 
invariante per il metodo escape( ). La tabella 
completa delle codifiche per tutti i caratteri 
ASCII compresi tra 32 e 126 è presente nel 
codice allegato al presente articolo dove è 
possibile trovare lo script per il calcolo di que- 
sta tabella. Su una generica stringa, i tre meto- 
di forniranno in output stringhe differenti, 
come nel seguente esempio di codice: 



encodeURI(strEsempio) = 

j@vascript%20%C3%A8%20bello%20?%20( 
ma%20s%C3%AC%20che%20%C3%A8%20bello!) 
encodeURIComponent(strEsempio) = 

j%40vascript%20%C3%A8%20bello%20%3F%20 
(ma%20s%C3%AC%20che%20%C3%A8%20bello!) 
escape(strEsempio) = j@vascript%20%E8% 

20bello%20%3F%20%28ma%20s%EC%20che% 
20%E8%20bello%21%29 

È importate ricordare che nella manipolazio- 
ne delle stringhe URI o delle loro componenti 
non si deve mai fare uso del metodo escapef). 
Per quanto riguarda i metodi decodeURIQ, de- 
codeURIComponent( ) ed unescape( ), tali me- 
todi eseguono esattamente l'operazione in- 
versa dei corrispettivi encodeURI( ), encode- 
URIComponent( ) ed escape (). 
L'esempio di codice: 

strStringa= "j@vascript è bello ? (ma sì che è bello!)"; 

document.write("decodeURI(encodeURI(strStringa)) = 

" + decodeURI(encodeURI(strStringa)) + "<br>"); 

document.write("decodeURIComponent(encodeURICo 

mponent(strStringa)) = " + decodeURIComponent( 

encodeURIComponent(strStringa)) + "<br>"); 

document.write("unescape(escape(strStringa)) = " 

+ unescape(escape(strStringa)) + "<br>"); 

restituisce per tutti e tre i casi il valore della 
stringa strStringa di partenza. 



CONCLUSIONI 

La corretta gestione delle URI ci consente di 
scrivere pagine WEB efficaci quando l'output 
si presenta in modo molto complesso. D'altra 
parte i link sono le fondamenta del web. 

Danilo Berta 



DEFINIZIONE DI URI. 




METODI ESCAPE 
ED UMESCAPE... 

I metodi escape ed une- 
scape sono stati depre- 
cato dallECMA, ma lo 
descriveremo perché 
ancora utilizzato in casi 
particolari. Per quanto 
riguarda le possibilità 
di utilizzo dei metodi, 
questi non devono 
essere utilizzati per la 
gestione delle URI, cosa 
che si faceva un po' di 
tempo fa. Personalmen- 
te non riesco a trovare 
nessun esempio 
dell'utilizzo di questo 
metodo, a meno che 
non si pensi a qualche 
script CGI un po' datato 
che utilizza unescape( ) 
per decodificare le 
stringhe e quindi si 
aspetta di ricevere in in- 
put stringhe codificate 
con escape(). In definiti- 
va, se avete bisogno di 
usarlo, qualcuno vi dirà 
di usarlo... 



var strEsempio = "j@vascript è bello ? 

(ma sì che è bello!)"; 
document.write("strEsempio = " + strEsempio 

+ "<br>"); 
document.write("encodeURI(strEsempio) = " 

+ encodeURI(strEsempio) + "<br>"); 
document.write("encodeURIComponent(strEsempio) 

= " + encodeURIComponent(strEsempio) + "<br>"); 
document.write("escape(strEsempio) = " 

+ escape(strEsempio) + "<br>") 

nel quale i tre metodi restituiscono come out- 
put tre stringhe diverse: 

strEsempio = j@vascript è bello ? (ma sì che è bello!) 



Il termine URI è un acronimo che 
sta ad indicare: Uniform Resource 
Identificator, è in pratica una 
stringa di caratteri che, seguendo 
ben precise regole di sintassi, 
permette l'individuazione 
univoca di una risorsa su 
Internet. Facciamo notare che 
"una risorsa su Internet" non è 
solo l'indirizzo di una pagina 
web, definito da una URL 
(Uniform Resource Locator), ma 
anche un indirizzo di posta 
elettronica, un indirizzo di news 
su USENET, etc. 
Quindi il concetto di URI in 



qualche modo estende quello di 
URL. 

La definizione dettagliata delle 
regole semantiche alle quali 
deve sottostare una URI sono 
descritte nella RFC del W3C de- 
nominata RFC2396 e raggiungibi- 
le al seguente indirizzo... URI... 
( http://www.w3.orq/2002/11/dbooth- 
names /rfc2396-numbered 
clean.htm ). 

Senza entrare troppo nel merito, 
il paragrafo 1.6 di questa "Re- 
guest for Comment" definisce in 
modo rigoroso la struttura 
generale di una URI. 
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Gestire i contatti 
con Symbian OS 

Nella programmazione dei cellulari è importante capire come vengono 
gestite le applicazioni standard prima di avventurarci nella creazione 
di un nostro programma. Analizziamo il funzionamento della rubrica 




Nei precedenti articoli abbiamo de- 
scritto la struttura generica di un 
programma per Symbian OS, più in 
particolare per la piattaforma Serie 60 di casa 
Nokia. Abbiamo anche parlato di come il fra- 
mework grafico possa essere utilizzato per 
rappresentare le informazioni a video. A parti- 
re da questo articolo vedremo cosa Symbian 
OS ci offre nello specifico, trattando i singoli 
argomenti come dei mattoncini nella costru- 
zione del software finale. Seguendo questo 
profilo, non possiamo non iniziare dalla ge- 
stione dei contatti che risiedono sul telefono 
cellulare. Come al solito, la parte teorica ci 
servirà per capire i meccanismi di funziona- 
mento, e la parte pratica, tramite l'ausilio di 
piccoli esempi, ci aiuterà ad applicare le co- 
noscenze acquisite. 



contatto. Symbian OS gestisce i propri dati 
tramite le vCard in maniera trasparente per il 
programmatore e per l'utente. Ciò significa 
che l'accesso e la manipolazione delle infor- 
mazioni è possibile solo tramite l'ausilio di 
opportune API, che esonerano dal compren- 
dere "dove" e "in che modo" questi dati devo- 
no essere conservati. 



IL DATABASE 
DEI CONTATTI 

Dal punto di vista fisico il database standard 
dei contatti è contenuto interamente nel file 
contacts.cdb che risiede nella directory \sy- 
stemXdata. Dal punto di vista logico, è possibi- 
le operare sul database tramite la classe 
CContactDataba.se. Prima di ogni cosa è dun- 




REQUISITI 



W4.UJMA.\m 



Basi di C++, basi di 
Symbian C++ 



^ Visual C++ 6 o sup., 
S8 ActivePerl, 

Nokia SDK 1.2 o sup. 



t^j^a_j_j^ 



Tempo di realizzazione 



CONTATTI E VCARDS 

I contatti, sui moderni smartphone, non sono 
altro che un insieme di campi contenenti 
un'etichetta ed un valore. Ogni campo può 
rappresentare un diverso tipo di dato, come 
una stringa, un numero o una data. Inoltre il 
numero di campi è variabile, in modo da 
abbracciare le necessità di una molteplicità di 
utenti. Pensiamo, ad esempio, ad una persona 
con più nomi o più numeri da memorizzare. 
Poniamoci adesso in un caso reale. Cosa suc- 
cederebbe se, cambiando il cellulare, dovessi- 
mo trasferire i contatti da un dispositivo al- 
l'altro? E se fosse un palmare? 
Affinché i contatti possano essere trasferiti da 
un dispositivo all'altro senza problemi è 
necessario che tutte le periferiche memorizzi- 
no i contatti secondo uno standard preciso. 
Tale standard si chiama vCard (RFC 1521). 
Una vCard esprime il modo in cui devono es- 
sere rappresentate le informazioni inerenti un 



TIPOLOGIE DI CAMPO 



È possibile trovare un 
elenco dettagliato di 
tutti i tipi di campo 
nel file cntdef.h pre- 
sente ovviamente in 
ogni SDK. Tali costanti 
devono essere passa- 
te come secondo 
parametro nella co- 
struzione dell'oggetto 
CContactltemField. 

KUidContactFieldPhone 

Number 
KuidContactFieldFamily 
Name 




KuidContactFieldUrl 

KuidContactFieldPicture 

KuidContactFieldRingTone 

Il file header sopra 
citato contiene anche 
le costanti per il map- 
ping. Eccone alcune: 

Nome KUidContactField 

VCa rdMapUnusedN 

Cognome KUidContactField 

VCa rdMapUnusedN 

Compagnia KUidContact 

FieldVCarcMapORG 

Occupazione KUidContact 

FieldVCarcMapTITLE 

Telefono KUidContact 

FieldVCarcMapTEL 

Email/internet KUidContact 

FieldVCarcMapEMAILINT 

ERNET 
J 


KuidContactFieldAdditi 

onalName 
KuidContactFieldEMail 
KuidContactFieldSms 
KuidContactFieldNote 
KuidContactFieldBirthday 
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que necessario creare l'oggetto attraverso il 
quale effettuare le operazioni. Ciò è possibile 
grazie alla chiamata CContactDataba.se:: 
OpelLQ che restituisce un puntatore ad un 
oggetto della stessa classe. Il seguente codice 
illustra la procedura: 

CcontactDatabase * database = 

CContactDatabase: :OpenL(); 
CleanupStack: :PushL(database); 

La chiamata OpenLQ effettua l'apertura del 
database, identificato come un descrittore di 
file, passato come parametro. L'assenza di 
parametri implica l'apertura del database di 
default. Nei nostri esempi manipoleremo so- 
lo il database di default, tuttavia, la funzione 
CreateLQ ci permette di creare un nuovo da- 
tabase in un qualsiasi punto del filesystem. 
L'uso del CleanupStuck è necessario in quan- 
to la classe non possiede un metodo CloseQ e 
di default le risorse appartenenti all'oggetto 
vengono liberate solo quando su di esso viene 
effettuata una chiamata delete. Nel caso in 
cui il programma uscisse a causa di un errore, 
il sistema in automatico prowederebbe a ef- 
fettuare il delete di tutti gli oggetti presenti 
nel CleanupStuck. Solo dopo aver effettuato 
le operazioni è possibile liberare le risorse. 

TInt numeroContatti = database->CountL(); 
CleanupStuck: :PopAndDestroy(database); 

Nell'esempio viene semplicemente richiama- 
ta la funzione CountLQ ottenendo così il nu- 
mero complessivo di contatti presenti nel da- 
tabase. Viene quindi prelevato l'oggetto dal 
CleanupStuck e in seguito distrutto. 
Un ruolo molto importante è rivestito dalle 
operazioni di compressione e recupero nel- 
l'ambito del database dei contatti. Dal mo- 
mento che la memoria fisica non è subito li- 
berata in seguito alla cancellazione di un 
contatto, è necessario effettuare una compat- 
tazione dei dati assimilabile alla deframmen- 
tazione. Essendo un'operazione che richiede 
del tempo è opportuno eseguirla solo quando 
realmente necessaria. Vediamo come: 

if (database- >CompressRequired()) 

{ 

database- >CompactL(); 

} 

CompressRequiredO analizza lo spazio libero 
e verifica l'effettiva necessità di una compat- 
tazione. Se invece ci troviamo nella circostan- 
za di un database corrotto (con errori), pos- 



siamo provare ad effettuare un ripristino tra- 
mite il seguente codice: 

if (database->IsDamaged()) { 
data base- > RecoverL() ; 



AGGIUNGERE 
UHI CONTATTO 

L'aggiunta di un nuovo contatto si può sche- 
matizzare in tre passi. Assumeremo di avere 
precedentemente aperto il database di de- 
fault. 

1. Creazione di un oggetto CContactltem 

2. Aggiunta delle informazioni al contatto 

3. Aggiunta del contatto al database 

I dati appartenenti al contatto, seguendo lo 
standard vCard, sono suddivisi per campi. 
Ogni campo è rappresentato da una coppia 
etichetta-valore ed appartiene ad una deter- 
minata tipologia. Un campo relativo ad un 
numero telefonico deve poter essere distinto 
da un campo relativo ad una data, nonostan- 
te entrambi contengano numeri. In realtà, 
come vedremo, l'informazione è sempre rap- 
presentata tramite stringhe di testo. Ciò che 
conta è la connotazione che vogliamo dare ai 
singoli campi. Per chiarire le idee diamo 
un'occhiata al codice: 

_LIT (LabelNome, "Nome"); 

_LIT(Nome, "IoProgrammo"); 

_LIT(LabelTelefono, "Tel Redazione"); 

J_IT(Telefono, "02831212"); 

J_IT(l_abelEmail, "Email"); 

_LIT(Email, "servizioabbonati@edmaster.it"); 



CcontactDatabase 



database = 

CContactDatabase: :OpenL(); 



CleanupStack: :PushL(database); 



CContactltem * contatto = CContactCard: :NewLC(); 
CContactltemField * campo = 

CContactltemField: :NewLC(KStorageTypeText, 
KUidContactFieldFamilyName); 
campo- >SetMapping( 

KUidContactFieldVCardMapUnusedN); 
campo- >Setl_abelL( Label Nome); 
campo- >TextStorage()->SetTextL( nome); 
contatto- >AddField(*campo); 
CleanupStack: :Pop(); 
campo = CContactltemField: :NewLC( 

KStorageTypeText, KUidContactFieldPhoneNumber); 
campo->SetMapping(KUidContactFieldVCardMapTEL); 





I TUOI APPUNTI 
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campo->SetLabelL(LabelTelefono); 



campo->TextStorage()->SetTextl_(Telefono); 



contatto- >AddField(*campo); 



CleanupStack: :Pop(); 



campo = CContactltemField: :NewLC( 

KStorageTypeText, KUidContactFieldEMail); 
campo->SetMapping( 

KUidContactFieldVCardMapEMAILINTERNET); 



cam pò- >SetLabelL(Label Email); 



cam pò- >TextStorage()->SetTextL( Email); 



contatto- >AddField(*campo); 



CleanupStack: :Pop(); 



database- >AddNewContactL(*contatto); 
CleanupStack: :PopAndDestroy(2); 

Le due classi di riferimento sono CContact- 
Item e CContactltemField. La chiamata New- 
LC() ci restituisce il puntatore ad un oggetto 
della classe. 

Seguendo le convenzioni Symbian, tale og- 
getto è già inserito nel CleanupStuck. Alla fine 
di ogni blocco effettuiamo quindi la chiama- 
ta PopO- La costruzione del campo richiede 
due parametri. 

Notiamo che il primo di essi è sempre KStora- 
geTypeText, proprio perché in genere si è soli- 
ti usare delle stringhe di testo. Il secondo ca- 
ratterizza invece il campo secondo lo scopo 
per cui è stato inserito. 

Nell'esempio utilizziamo un campo di tipo 
generico, uno di tipo telefono e uno di tipo 
email/ internet. La funzione SetMappingQ 
abilita il supporto vCard ed è sempre prefe- 
ribile utilizzarla. Anche in questo caso dob- 
biamo specificare il tipo di mapping, relativo 
al tipo di campo. Un piccolo elenco di para- 
metri è presente nel box illustrativo. Per fi- 
nire, la funzione SetLabelLQ si preoccupa di 
assegnare l'etichetta del campo, mentre Text- 
Storage()->SetTextL() ne assegna il valore. 



RICERCA E LETTURA 
DI UM CONTATTO 

Ogni contatto nel database è identificato da 
un numero unico chiamato Id (identificati- 
vo). Per poter richiedere l'accesso ad un spe- 
cifico contatto, e quindi ottenerne il puntato- 
re all'oggetto, è necessario possedere il corri- 
spondente Id. Il modo più semplice per otte- 
nere l'identificativo di un contatto è scorrere 
il database effettuando una ricerca per cam- 
po. La rubrica di default, naturalmente, espo- 
ne le informazioni per via grafica, utilizzando 
delle liste. Essa richiama semplicemente la 
funzione IdQ sull'oggetto CContactltem sele- 
zionato, di cui si conosce il riferimento. Lad- 
dove quindi non sappiamo nulla sul databa- 
se, dobbiamo effettuare un'iterazione in cer- 
ca di un qualcosa di specifico. Ecco il codice: 



CContactDatabase 



database = 

CContactDatabase: :Openl_(); 



CleanupStuck: :PushL(database); 



CContactltemFieldDef fieldDef = new (ELeave) 

CContactItemFieldDef(); 
fieldDef- >AppendL(KUidContactFieldFamilyName); 



_LIT( Token, "IoProgrammo"); 



CìdleFinder * finder = database->FìndAsyncL( 

Token, fieldDef, this); 

Il punto chiave consiste nella chiamata alla 
funzione FindAsyncLQ , ottimo servizio offer- 
to dalla classe CContactDatabase. Tale fun- 
zione crea un elenco di Id relativi ai contatti 
che corrispondono ai parametri di ricerca. Il 
tipo di campo viene inserito all'interno di un 
oggetto CContactltemFieldSet e poi passato 
alla procedura di ricerca. È possibile anche 
inserire più tipi di campo richiamando più 
volte AppendLQ. CContactDatabase offre di- 
verse funzionalità di ricerca. Si è preferita una 



CREAZIONE DI UN'APPLICAZIONE 



Setup Environment Varia bles 



E 



i 0! ,'v! ■ 

I '.ilici WQ'.i: ì'.i. ■ . . . ■■ ■ : ■■ . 

ir vour BIH directory. 



** Register Environment Varìables 



D Installiamo gli strumenti che ci 
servono: Nokia SDK 1.2, Microsoft 
Visual C++ 6.0 e ActivePerl. Durante 
l'installazione di Visual C++ ricordiamoci 
di settare le variabili d'ambiente come 
in figura. 
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H Aggiungiamo a Visual C++ il tem- 
plate Nokia. Copiamo 
avkonappwiz.awx e avkonappwiz.hlp da 
Symbian\6.1\Series60\Series60Tools\appli 
cationwizard a Microsoft Visual Studio 
\Common\MSDev98\Template\ 
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Apriamo Visual C++ e clicchiamo 
su File, poi su New. Dalla tab pro- 
jeets selezioniamo Series 60 AppWizard, 
digitiamo il nome del progetto, settia- 
mo la directory. Nel dialog inseriamo il 
nome dell'applicazione. 




► 102 /Giugno 2005 



http://www.ioprogrammo.it 




Mobile 



I 



T CORSI BASE 




ricerca asincrona per migliorare le prestazio- 
ni. L'ultimo parametro, nel nostro caso this, 
deve essere un oggetto che implementa l'in- 
terfaccia MIdleFindObserver, contenente una 
funzione chiamata IdleFindCallbackQ. All'in- 
terno di tale funzione, richiamata ogni 16 
contatti, inseriamo il codice che ci permette- 
rà di manipolare l'informazione cercata. 

void CldleFindObserver: :IdleFindCallback() 

{ 
if ( finder->IsComplete() ) 



{ 



if ( finder->Error() == KErrNone ) 



{ 



CContactldArray * risultato = finder-> 

TakeContactIds(); 
for (TInt i=0; i<risultato->Count(); i++) 



{ 



TInt cardld = (*risulato)[i]; 



_LIT(message, "Contatto Trovato ! ") ; 
CAknConfirmationNote * note = new (ELeave) 
CAknConfirmationNote(); 



note-> ExecuteLD(message) ; 



} 



delete risultato; 



} 



delete finder; 



delete fieldDef; 



} 



Nell'esempio, a ricerca ultimata, viene prele- 
vato l'insieme di Id relativi ai contatti trovati e 
viene visualizzata una semplice informazione 
sul display. Un'interessante alternativa consi- 
ste nell' effettuare la ricerca per numero te- 
lefonico. Le API per i contatti si preoccupano 
persino di effettuare il matching su tutti i 
campi che siano stati catalogati come KUid- 



ContactFieldPhoneNumber. Tale lavoro è com- 
piuto dalla funzione PhoneMatchListLQ, 
ovviamente appartenente a CContactDataba- 
se. Prima però è necessaria un'indicizzazione 
tramite le chiamate InitLoadPhoneMatchesLQ 
e LoadPhoneMatchesLQ. Vediamo il codice: 

TInt itemRimasti = database-> 

InitLoadPhoneMatchesLQ; 
while ( itemRimasti > 0) { 



itemRimasti = database->LoadPhoneMatchesL(); 



} 



_LIT( telefono, "12345678"); 



CContactldArray * idContatti = database-> 

PhoneMatchListL(telefono); 

Dal momento che l'indicizzazione è asincro- 
na dobbiamo utilizzare un ciclo while per 
aspettare il termine dell'operazione. La ricer- 
ca avviene inoltre sulle ultime otto cifre del 
numero di telefono. 



APPLICAZIONI 

Avendo assimilato i concetti base, possiamo 
adesso manipolare i contatti del telefono di- 
rettamente all'interno dei nostri programmi. 
Tutto dipende ovviamente da ciò che voglia- 
mo implementare. È possibile ad esempio 
scrivere un software che effettui un backup 
ogni sette giorni, oppure un album fotografi- 
co con il riferimento ai contatti, oppure un 
searcher avanzato che restituisca tutti i nomi 
delle persone che hanno un numero telefoni- 
co che inizia con XXXX (pensate quando sul 
dettaglio della bolletta non riuscite a ricono- 
scere un numero perché mancano le ultime 
tre cifre) . 

Antonio Trapani 




C++ 



CIdleFindObserver : : IdleFindCallback [) { 
[ f indet->IsComplete () ) { 
f [ f inder->Ecroc () == KErrWone ) { 
CContactldArray * risultato = f inder->TakeCo 
fot (TInt i=0; i<ri3Ultato->Cotmt ( ) ; i++) { 
TInt catdld = ( *risulato] [i] ; 
_L IT (messale, "Contatto Trovato \") ; 
CAknConf irmationNote * note = netr (ELeave) 
note->ExecuteLD (message) ; 



} 
dele 



ulta 



elete finder; 
elete fieldDef; 



□ Scriviamo il nostro codice aggiun- 
gendo funzioni alla struttura stan- 
dard o creiamo nuove classi adatte alle 
nostre esigenze. Il codice proposto 
all'interno di questo articolo deve essere 
scritto a questo punto. 




Apriamo una console dei comandi 
e posizionamoci nella directory 
group appartenente al nostro progetto. 
Digitiamo bldmake bldfiles e subito do- 
po abld build thumb urei. Il programma 
è adesso compilato. 



Per creare il file d'installazione 
portiamoci invece nella directory 
instali e digitiamo makesis HelloWorld 
.pkg. Trasferiamo HelloWorld. sis sul 
telefonino, installiamolo, lanciamolo, e 
godiamoci i frutti del nostro lavoro. 
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TIPS & TRICKS T ■ Una raccolta di trucchi da tenere a portata di... mouse 



I trucchi del mestiere 

Tips & Tricks 

Questa rubrica raccoglie trucchi e piccoli pezzi di codice, frutto dell'esperienza di chi programma, che solitamente non 
trovano posto nei manuali. Alcuni di essi sono proposti dalla redazione, altri provengono da una ricerca su Internet, altri 
ancora ci giungono dai lettori. Chi volesse contribuire, potrà inviare i suoi Tips&Tricks preferiti. Una volta selezionati, 
saranno pubblicati nella rubrica. Il codice completo dei tips è presente nel CD allegato nella directory \tips\o sul Web 
all'indirizzo: cdrom.ioprogrammo.it. 




VISUAL 
BASIC 




PHP 



CONCATENARE STRINGHE 
IH! VISUAL BASIC 

Ovviamente si potrebbe utilizzare l'operatore &, tuttavia l'uso 
dell'operatore & fa si che se concatenate un certo numero di pic- 
cole stringhe in una più grande, viene allocata e deallocata la 
memoria ogni volta che l'operatore viene incontrato. 
Un modo per ottimizzare la concatenazione è usare la seguente 
classe. 



Private strText 



As String 



Public IngAllocated 



As Long 



Public IngUsed 



As Long 



COME CONTROLLARE 

SE UN FILE ESISTE IN PHP? 

<?php 

$filename = '/path/to/foo.txt'; 

if (file_exists($filename)) 

{ 

print "Il file $filename esiste"; 
} else 

{ 

print "Il file $filename non esiste"; 



Public IngAllocSize 



As Long 



Private Sub Class_Initialize() 



IngAllocSize = 1000 



End Sub 



Public Sub Add(strAddString As String) 



Dim IngLen 



As Long 



Dim IngToAllocate As Long 



IngLen = Len(strAddString) 



If IngLen > Then 



If IngUsed + IngLen > IngAllocated Then 



IngToAllocate = IngAllocSize * (1 + (IngUsed + 

IngLen - IngAllocated) \ IngAllocSize) 
strText = strText & String$(lngToAllocate, " ") 
IngAllocated = IngAllocated + IngToAllocate 
End If 



Mid$(strText, IngUsed + 1, IngLen) = strAddString 



IngUsed = IngUsed + IngLen 



End If 



End Sub 



Public Functìon GetStrQ As String 



GetStr = Mid$(strText, 1, IngUsed) 



End Function 



COME VISUALIZZARE 

IN QUANTO TEMPO VIENE 

CARICATA UNA PAGINA PHP? 



<?php 



// Funzione: restituisce il tempo in microsecondi 



function getmicrotime() 



{ 



list($usec, $sec) = explode(' ', microtime()); 



return ((float)$usec + (float)$sec); 



} 



$tempo_inizio = getmicrotime(); 



//Non fare niente, 1000 volte 



for ($i=0; $i<1000; ++$i); 



//Si sottrae dal microtempo attuale quello iniziale 
$tempo_esecuzione = getmicrotime() - $tempo_inizio; 

//Otteniamo cosÀ/À-i il tempo impiegato per eseguire le istruzioni 

dello script 

echo 'Tempo di esecuzione: ', $tempo_esecuzione , ' secondi'; 
?> 
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ASP.IMET 



COME ACCEDERE 

A UHI DATABASE MYSQL? 

<%@ import Namespace="System,Data" %> 

<%@ import Namespace="System,Data.Odbc" %> 

<%@ Page Language="C#" %> 

<script runat="server"> 

public void Page_Load(Object sender, EventArgs e) { 

DataTable dtRecords = GetDataTable("SELECT * FROM newone"); 

foreach(DataRow dr in dtRecords. Rows) { 

Response.Write(dr["FirstName"].ToString() + " " 

+ dr["LastName"].ToString() + "<br/>");> } 

private static string GetConnectionQ { 

return "DRIVER={MySQL ODBC 3.51 Driver}; 

Server=localhost;Database=testdatabase";} 
public static DataTable GetDataTable(string sql) { 

DataTable rt = new DataTableQ; 

DataSet ds = new DataSetQ; 

OdbcDataAdapter da = new OdbcDataAdapterQ; 

OdbcConnection con = new 

OdbcConnection(GetConnection()); 

OdbcCommand cmd = new OdbcCommand(sql, con); 

da.SelectCommand = cmd; 

da.Fill(ds); 

try{ 



rt = ds.Tables[0]; } 


catch { 


rt = nuli; 


} 


return rt; 


} 


</script> 




JAVA 



COME APRIRE CHIUDERE 
VANO CD DA JAVA 

Java non offre nativamente il supporto per l'accesso a tale 
funzionalità. Possiamo ovviare a questa limitazione appog- 
giandoci al codice messo a disposizione dal nostro sistema 
operativo, utilizzando JNI. Con questa classe possiamo usare 
delle semplici istruzioni come queste: 



code: 



String drive = "E: 



if(!DiscTrayFacility.open (drive)) 



jL 



System. err.println(DiscTrayFacility.getErrorMessage()); 



} else 



jL 



System. out.println("Lettore " + drive + " aperto"); 



} 



r""""ì IL TIP DEL MESE 

C++ COME APRIRE IL VANO 
L J DEL CD IH! LINUX CON C++ 

Tip fornito da Domenico Testa cerr << "Impossibile aprire il device " << device 




<< ".Codice errore " << ermo << endl; 




#include <iostream> 


return 1; 




#include <string> 


} 




using namespace std; 


// Apertura del cassettino: 




#include <errno.h> 


if(iOCtl(drive, CDROMEJECT)) 




#include <fcntl.h> 


{ 




#include <sys/ioctl.h> 


cerr << "Impossibile aprire il vano ed del device " << device 




#include <sys/types.h> 


<< ". Codice errore " << ermo << endl; 




#include <sys/stat.h> 


} 




#include <linux/cdrom.h> 


cout << "Vano ed aperto per " << device << endl; 




int main(int argc, char *argv[]) 


// Chiusura del cassettino: 




{ 


if(ioctl(drive, CDROMCLOSETRAY)) 




string device = "/dev/cdrom"; 


{ 




if(argc > 1) 


cerr << "Impossibile chiudere il vano ed del device " << device 




{device = argv[l]; } 


<< ". Codice errore " << ermo << endl; 




// Apertura del device: 


} 




int drive = open(device.c_str(), 0_RDONLY | 0_NONBLOCK); 
if(-l == drive) 


cout << "Vano ed chiuso per " << device << endl; 




return 0; 


. 


{ 




} 
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Data entry avanzati in Access 



Il data entry è un'operazione 
effettuata spesso da utenti 
che non hanno esperienza 
approfondita in campo infor- 
matico. È importante realiz- 
zare maschere di input che 
facilitino il compito a chi 
deve inserire i dati. Bisogna 
progettare prima e sviluppare 
poi una form che sia in grado 
di accogliere nuovi record per 
una generica tabella di 
Access. La procedura è bana- 
le se si tratta di una tabella 



che non ha alcuna relazione 
con altre tabelle. Invece, nel 
caso in cui vi siano associa- 
zioni, ad esempio del tipo 
uno a molti organizzare un 
input efficiente richiede mag- 
giore accortezza. Scartando a 
priori la possibilità di inserire 
nella tabella la chiave ester- 
na, ovvero l'identificativo 
della tabella relazionata; 
bisogna trovare un modo per 
inserire nella form di input il 
riferimento testuale al record, 



che non sia un asettico 
numero, come la chiave 
esterna. Nell'esempio consi- 
dereremo una galleria di 
opere d'arte, dove le due 
tabelle OPERA e ARTISTA 
contengono rispettivamente 
informazioni sulle opere d'ar- 
te -quadri- e sugli artisti che 
le hanno dipinte. Nella tabel- 
la opera tra i vari attributi 
appare IDA come riferimento 
all'artista, precisamente alla 
sua chiave. È questo l'attri- 



buto che crea un legame tra 
le due tabelle. Nella masche- 
ra di input vogliamo leggere 
un record completo della 
tabella opera, ma allo stesso 
tempo quando si tratterà di 
specificare l'artista che ha 
prodotto l'opera vogliamo far 
apparire da un menu di nomi 
degli artisti contenuti nella 
tabella apposita. In automati- 
co verrà associata al nome 
dell'artista la sua chiave. 

Fabio Grimaldi 



CREAZIONE GUIDATA 
DI UNA MASCHERA 



ÈÌ galleria : Database (formato file di Access 2000) QBIS 


l^fJApri ^Struttura ^ Nuovo -d > sE°: Ut 


Oggetti 


J Crea una maschera in visualizzazione Struttura 

G'3-2 ;::-] maschi '-r:i. ;;/;■■ ■■i : .; n- ■ :-=.•; .: :: - 


U Tabelle 
Dpi Query 


ED Maschere 


B Report 
Tm| Pagine 
2 Macro 
«^ Moduli 


Gruppi 


fai Preferiti 





Il primo passo, dopo aver lanciato Access, è quello di 
selezionare dal raccoglitore degli strumenti la ma- 
schera. Decidiamo, per semplificare la procedura, di 
avviare la creazione guidata. Ricordo che l'obiettivo è 
quello di produrre una form che realizzi l'input per la 
tabella OPERA. Il DB contiene già dei dati per effet- 
tuare la prova. 



<2> AVVIO DELLA PROCEDURA 
GUIDATA 



Creazione guidata Maschera 



Scegliere I campi daindudei ; nella maschera. 
E possibile scegliere fa più 'Quelle o query, 



Tabelle/query 
|Tabella: OPERA 



^3 

Carnpj selezionati: 



IDO 

TITOLO 
ANNO 

luc :.o 



I 



Nella finestra di dialogo selezionare la tabella OPERA, 
per la quale si vuole realizzare il data entry. 
Successivamente, cliccando sulla doppia freccia si 
decide di riportare nella maschera tutti gli attributi 
della tabella. Al termine della procedura, dopo aver 
scelto il tipo di maschera e il layout, si opterà per vi- 
sionare la modalità struttura. 



: 3 > AGGIUNTA DI UNA CASELLA 
COMBINATA 




Dal raccoglitore di strumenti si aggiunge una ca- 
sella combinata per creare il menu. La si aggiun- 
ge alla maschera che è ancora in formato struttu- 
ra. Si rimuove l'attributo IDA, ora sostituito con il 
nuovo oggetto e si sistema la casella combinata e 
il titolo. Cliccando su di essa si avvia la procedu- 
ra di associazione di valori alla casella. 



<4> RICERCA DEI VALORI 
SULLA TADELLA 



Creazione guidata Casella di riepilogo 
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nella casella di riepilogo 
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Si opta per la ricerca di valori sulla tabella. La finestra 
seguente ci permette di selezionare la tabella ARTISTA 
e il campo NOMIN. Adesso il menu apparirà in modo 
corretto. Resta solo da associare ai valori che appari- 
ranno nella lista la corrispondente chiave. Di fatto noi 
sceglieremo una nominativo e invieremo un codice. 



MEMORIZZAZIONE IN UN 
ATTRIDUTO CHIAVE ESTERNA 



Creazione guidata Casella dì riepìlogo 
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!'■' I " 



X 



n. 



La procedura in corso chiede se memorizzare il valore 
selezionato o altro. Indichiamo la seconda opzione e 
così scegliendo tra gli attributi preleviamo IDA. Così 
NOMINól ARTISTA sarà associato alla sua chiave IDA 
che è anche chiave esterna della tabella di cui stiamo 
producendo la maschera di input. 



<6> OSSERVIAMO IL 
RISULTATO FINALE 



H ni Ti FNTPY CIDFD1 














14 L'alba 


ffl 




San Pietroburgo 

iGauguin Paul 


Re 


cord: _HJ i 1 1 13 J| Matisse Henri 



Non resta che apprezzare il risultato ottenuto. 
Chiudendo e salvando la maschera si ha la possi- 
bilità di riaprirla in modalità di esecuzione. 
Si vede come per una determinata opera che si in- 
serisce, si possa scegliere tra una lista di artisti. 
Vale anche per la visualizzazione. 
Se l'artista non è presente nella lista bisogna in- 
serirlo preventivamente nella tabella ARTISTA. 
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La prima applicazione visuale in DEV-C++ 



In passato per gli sviluppa- 
tori C e C++ il passaggio 
dalla programmazione tradi- 
zionale alla programmazione 
visuale ha segnato un ele- 
mento di difficoltà. Produrre 
codice utilizzando le win 
API, non sempre è stata una 
passeggiata. Il desiderio di 
molti programmatori è scrive- 
re il codice puro che risolve il 
problema che sono chiamati 
a risolvere, senza doversi oc- 



cupare dell'interfaccia del- 
l'applicazione. DEV-C++, for- 
nisce alcune facilities inte- 
ressanti che consentono al 
programmatore di svincolarsi 
dalla realizzazione dell'inter- 
faccia grafica. In effetti, si 
riesce quasi totalmente a se- 
parare il codice per la solu- 
zione del problema con quel- 
lo per la gestione delle risor- 
se grafiche. Ma come gestire 
queste ultime? La teoria a ta- 



le proposito consta di una 
buona quantità di nozioni. 
Un approccio tipico dei pro- 
grammatori, tenta di abbatte- 
re le eventuali carenze teori- 
che facendo uso di esempi. 
In Dev-C++ vi sono un suffi- 
ciente numero di progetti che 
aiutano il programmatore 
sprovveduto a riguardo. Os- 
serviamo uno degli esempi 
per acquisire l'abilità di ma- 
nipolare finestre. Noteremo 



che facilmente andando a 
spulciare tra le linee di codi- 
ce dell'esempio si compren- 
deranno alcune nozioni per la 
gestione delle winAPI. 
L'esempio genera semplice- 
mente una finestra con una 
sola scritta, la classica "Hello 
world!" è inserisce un botto- 
ne per la chiusura della stes- 
sa. Vediamo come procedere 
per ottenere tale risultato. 

Stefano Vena 



<1 > APERTURA DEL PROGETTO 
DI ESEMPIO 



□ Dev -C+ + 4.9.9.0 



File Modifica Cerca Visualizza Progetto 



Nuovo 



5^ Riapri 



Salva Ctrl+S 

Salva Come... Ctrl+F12 

Salva il Progetto corine. . . 



□ 



Dopo aver lanciato l'applicazione DEV-C++, dall'am- 
biente di sviluppo, apriamo un nuovo progetto. Dal 
menu file selezioniamo la voce apri progetto e andan- 
do a seguire il percorso C:\dev-cpp\examples\wintest 
selezioniamo appunto il progetto wintest, ossia l'in- 
sieme di file che implementano l'applicazione de- 
scritta. 



t2> COMPILAZIONE 
DELL'INTERO PROGETTO 



File Modifica Cerca Visualizza Progett 


l^iUDH^V A 


*> 


|JiJn igfj^ 


f @> 


I : 




Compila (Ctrl+F9) 


Progetto | Classi Debug 




- r^piWinfesi! 
J Teste 





Per produrre l'output è necessario compilare l'intero 
progetto. Ovviamente, Dev-C++ cercherà tra i file 
presenti nel progetto una radice; per così dire. Un file 
che richiama gli altri. Nel caso specifico il progetto è 
semplice e contiene un solo file che è main.c, codifi- 
cato per semplicità in C. Si, perché ricordo, che Dev- 
C++ compila C++eC. 



3> RISULTATO 
DELLA COMPILAZIONE 



. 



(Zompile Progress 






j Progress 


Log 


Compiler: 

Status: 

File: 




Default compiler 


Done. 





Warnings: 



Chiudi 



Cliccando sul tasto di compilazione si potrà osserva- 
re sulla finestra di stato che appare, la progressione 
dell'intera compilazione, l'eventuale link e la produ- 
zione del file eseguibile. Se si riscontrano errori que- 
sti verranno opportunamente segnalati. Nel nostro 
caso come mostrato, tutto è andato per il meglio e 
quindi possiamo procedere nell'osservazione del 
risultato. 



<4> L'APPLICAZIONE 
VIENE ESEGUITA 



^ n(xj 



Hello, World! 



Dalla barra degli strumenti, il bottone accanto alla 
compilazione ci consente di eseguire il progetto, ossia 
il file eseguibile prodotto. Osserviamo il semplice 
quanto funzionale risultato, una finestra con la frase 
"Hello world!" al centro e un bottone per chiudere la 
stessa. Premiamo questo ultimo. Ci apprestiamo a 
personalizzare il risultato, un modo per comprendere 
gli elementi grafico visuali. 



C5> PERSONALIZZAZIONE 
DEL RISULTATO 



/ * New create 










hwndButton = CreateWindow 








"tiottonEJ" , /* , 


imititi butto, 


-i ci 


53 S 


*/ 


"Uscita", 










US CHILD | US 


VISIELE | ES 


PUSHBUTTON, 


0, 0, ex, cy, 










hwnd, ' * Paren 


is this wlncìow. 


*/ 




(HMEHU) 1,/* Con 


*/ 






( (LPCREATESTRUCT) lPararn] ->hlnstance, 


LIULL 










1 

re. bottoni = re. bottoni / 2; 








DrawText (hdc 


"Ciao mondo 


, 


-1, 


£rc, 


DT SINGLELINE 


| DT CENTER 


DT 


VC ENTE R] ; 



Andando a manipolare il file main.c si possono com- 
prendere gli elementi base utilizzati. Per farlo modifi- 
chiamo alcuni di essi, come le scritte che appaiono 
all'interno della finestra e sopra il bottone. Italianiz- 
ziamo l'applicazione. Il percorso da seguire per la 
comprensione è quindi tracciato, modificare alcuni 
elementi per testare gli effetti di cambiamento sull'e- 
seguibile. 



NUOVA APPLICAZIONE 
OTTENUTA 



m Hello 




- 4llS 




Ciao mondo! 




Uscita 





Si ottiene una nuova applicazione, praticamente iden- 
tica alla precedente ma che ha le scritte in italiano. 
Notiamo anche che si tratta di una finestra standard 
che può essere ridimensionata, spostata, minimizza- 
ta, ingrandita e chiusa. Per terminare scegliamo di 
cliccare sul tasto Uscita. Pochi passi è abbiamo rag- 
giunto l'obiettivo. 
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Abilitiamo il trascinamento 
nelle nostre applicazioni .Net 



In molti programmi siamo 
ormai abituati all'uso del- 
l'operazione comunemente 
chiamata Drag and Drop. Si 
tratta di una operazione che 
ci consente di trascinare un 
elemento (una immagine, un 
testo, un link) all'interno di 



un altro software e di elabo- 
rarlo. Pensiamo ad esempio 
ad un comune client di 
posta: quando vogliamo 
inviare un file in allegato ad 
una mail, la cosa più como- 
da da fare è quella di trasci- 
nare l'allegato direttamente 



nel messaggio. In questo 
breve articolo vedremo come 
sia semplice attivare la stes- 
sa funzionalità nei nostri pro- 
grammi. Realizzeremo una 
semplice applicazione in cui 
potremmo trascinare un file 
e vederne l'anteprima. Sarà 



poi semplice implementare 
eventuali operazioni da com- 
piere con il file trascinato. 
Lo strumento che utilizzere- 
mo sarà VisualStudio.net, il 
linguaggio che abbiamo scel- 
to è l'ormai noto C# 

Michele Locuratolo 



UN NUOVO PROGETTO 
WINDOWS APPLICATION 



_ 



1 "1 Progetti di Visual Basic 
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Creiamo un nuovo progetto con Visual Studio .Net 
2003 scegliendo come tipo di applicazione "Applica- 
zione per Windows". Scegliamo il nome e la posizione 
e clicchiamo su 0K. 



< 4 GESTIAMO GLI EVENTI 



| Formi System .Windows. Form s. Form _^J 





| m 


f 



BindingContsctCh; 

CausesValidationC 

ChangeUICues 

Click 

Closed 

Closing 

ContextMenuCham 

CursorChanged 

Deattivate 

DockChanged 

Doubleclick 



Forml_DragD -r 



DragEnter 


F<jrml_DragEntei 


DragLeave 




Drag Over 




EnabledChanged 





Ora che il form può accettare il trascinamento di un 
file, dobbiamo gestire tale evento! Attiviamo quindi la 
scheda eventi del form e abilitiamo DragDrop e 
DragEner facendo doppio click su ognuno di essi. 



<2> AGGIUNGIAMO 
QUALCHE ELEMENTO 



^^,L..^ B .,.n> M .^^ hB ^.ih^«.^^,.. !miM >»iÉ. tt i K i. l ^ M .h WM . M É.i rt . ftl . w «ium»J3H£a 






mm ® ni £ffl 



>R 



ROGRAMMOb 



• !. H» Ih 



Costruiamo la nostra semplice applicazione aggiun- 
gendo al form vuoto una PictureBox ed una TextBox. 
La TextBox visualizzerà il percorso del file trascinato 
mentre la PictureBox mostrerà una anteprima del file. 



private void Form1_DragDrop(object sender, 
System.Windows.Forms.DraqEventArgs e) { 
string filePath = string.Empty; 
foreach (string fileName in (string[])e.Data.GetData( 
DataFormats.FileDrop)) 
filePath = fileName; 

tbxPath.Text = filePath; 

string ext = tbxPath.Text.Substringl 

filePath.IndexOfC'.")); 

if ( ext == ".gif" | ext == ".jpg" ) 

J 

pictureBoxLlmage = new Bitmap(tbxPath.Text); 



J 

else{ 

MessageBox.ShowC'...); 
> 



> 



Nell'evento DragDrop recuperiamo il nome ed il per- 
corso del file trascinato con string fileName in 
(string[])e. Data. GetData(DataFormats.FileDrop) e 
inseriamolo nella textbox. Se l'estensione del file è 
di .gif o .jpg, la inseriamo nella PictureBox per vi- 
sualizzarne una anteprima. 



<3> SETTIAMO LE PROPRIETÀ 



1 1 Pormi System-Windows, Forma. Form 

m\ 



m 



O (DataBindings) 
IH (DynamicPropertie 



(Name) 


Formi 




AcceptButton 


(nessuno) 




Accessi bleDescripI 


AccessìbleName 


AccessìbleRole 


Default 






True 


-1 


Autoscale 


True 




AutoScroll 


False 




AutoScrollMargin 


0: o 





<5> LAVORIAMO CONI FILE _ 



;B AutoScrollMinSize 0; 

BackColor j ~ J Control 

Backgroundlmage l | (nessuna) 
CancelButton (nessuno) 

CausesValidatìon True 



A Ilo w Drop 



La cosa importante da fare è specificare che il form 
deve essere in grado di gestire il trascinamento di un 
file. Per farlo, selezioniamo il form e nelle proprietà 
settiamo a True la voce "AllowDrop". 



L'APPLICAZIONE FINALE 



loR 



ROGRAMMQb 




|^ :\Documents and Settings\Mighell\Documer#-.lmmaginiVJogo_blog_2 



Ecco in nostro piccolo programma in funzione. Con lo 
stesso principio sarà possibile salvare l'immagine 
trascinata, copiare del testo, inserire un dato in un 
Data Base. 
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Scrivere e leggere 

un piccolo file di configurazione 



Agni buon programma 
che si rispetti ha 
delle impostazioni da sal- 
vare per la sua configura- 
zione. Se ci troviamo 
nella situazione di dover 
salvare i dati del nostro 
programma abbiamo due 
alternative usare il file di 
registro di Windows oppu- 



re affidarci ad un tradi- 
zionale file di configura- 
zione. Questo genere di 
file a differenza del file 
di registro ci permette di 
mantenere le impostazio- 
ni del programma anche 
dopo una formattazione 
(a patto che esso sia 
stato salvato). Quindi ora 



andiamo a vedere come 
si realizza un file di con- 
figurazione e come legge- 
re le informazioni salvate 
su esso. Ciò di cui abbia- 
mo bisogno è un compila- 
tore c++, un editor di 
testo e un po' di dimesti- 
chezza con c++. Per rea- 
lizzare il seguente esem- 



pio ho utilizzato Dev-C++ 
un ambiente di sviluppo 
c++ freeware molto leg- 
gero. Dev-C++ è scarica- 
bile gratuitamente dal 
sito web: www.blood- 
shed.net, oppure potete 
usare la versione conte- 
nuta nel CD allegato. 

Stefano Vena 



CREARE UN NUOVO 
PROGETTO CONSOLE 



! 



itroduction I MultiMedia I Scripting 



<É $ s 



Console Static Library DLL 

Application 



WKWidgets 
Frarne 



Descrizione: 
À console application (MSDOS window) 



O pzio n i del P rogetto: 



ConfigFile 



Oc 

DJ=in 



• Ok 



Per prima cosa lanciamo dev-c++, poi dal sottomenu 
Nuovo del menu File scegliamo la voce Progetto, poi 
scegliamo dalla sezione basic il tipo di progetto 
"Console Application" diamo un nome al nostro lavo- 
ro e diamo Pok. 



LA LETTURA 
DELLA CONFIGURAZIONE 

strinq temp; 

strinq nome, cognome; 

int anni; 

ifstream jncfjjj "confiq.cfg" ); 

if( incfg.failQ != ) return -1; 

incfg » temp » nome; 

incfg » temp » cognome; 

incfg » temp » anni; 

incfg. closeO; 

Istanziamo quattro variabili da utilizzare come suppor- 
to durante la lettura. Creiamo subito dopo uno stream di 
lettura (ifstream). La variabile incfg viene inizializzata 
utilizzando il costruttore della classe ifstream che pren- 
de come parametro il nome del file da aprire. Nel pro- 
cesso di lettura utilizziamo l'operatore di estrazione 
(») a cascata. Estraiamo la breve descrizione dallo 
stream e la assegnamo alla variabile temp poi andiamo 
a riempire le altre variabili con i dati letti sul file. Anche 
in questo caso andiamo a chiudere lo stream. 



LE PRIME RIGHE 
DI CODICE 

ttinclude <iostream> 
ttinclude <stdlib.h> 
ttinclude <fstream> 

using namespace std; 

int main ( int argc, char *argv[] ) { 

Il progetto contiene già un file con un semplice un 
programma c++, frutto dei modelli predefiniti uti- 
lizzati dall'ottimo dev-C++. 
Precisamente sono presenti due inclusioni <io- 
stream> e <stdlib.h> (oppure <cstdlìb> se usiamo 
gcc3.4.>ti ed una semplice implementazione di 
main. 

Aggiungiamo l'header <fstream> e andiamo al 
passo successivo. 



STAMPA 
DELLE OCCORRENZE 

cout « "Nome :"; 

cout « nome « endl; 



cout « "Cognome :"; 
cout « cognome « endl; 

cout « "Anni :" 

cout « anni « endl; 

systemC'PAUSE"); 

Dopo aver letto tutte le occorrenze dal file andiamo 
a stamparle sullo schermo della console. Dopo aver 
stampato il risultato attendiamo la pressione di un 
tasto da parte dell'utente. Il tutto si risolve con 
poche righe di codice. 

Utilizziamo l'istruzione sistem ("PAUSE") per mette- 
re il programma in attesa fino alla pressione di un 
tasto. Le righe precedenti sono sufficientemente 
semplici da non richiedere commento. 



SCRITTURA DEL FILE 
DI CONFIGURAZIONE 

ofstream outcfg( "confiq.cfg" ); 

if( outcfg.faiK) != ) return -1; 

outcfg « "Nome= " « "Mario" « endl; 

outcfg « "Cognome= " « "Rossi" « endl; 

outcfg « "Anni= " « 35 « endl; 

outcfg. closeO; 

La prima cosa da fare è dichiarare la variabile di 
tipo (ofstream) per lo stream di scrittura. 
Utilizziamo il costruttore che prende come parame- 
tro il nome del file così possiamo automaticamen- 
te creare il file di configurazione. 
Se il file scelto esiste già esso verrà sovrascritto. Il 
passo successivo è controllare se il file scelto è 
stato creato correttamente. Per fare ciò controllia- 
mo lo stream tramite il metodo "failO". Il prece- 
dente metodo restituisce un valore uguale a zero se 
tutto è andato bene. Per scrivere nello stream uti- 
lizziamo l'operatore di inserimento («) proprio 
come facciamo quando scriviamo con cout sulla 
console. 

La sintassi è semplice: inseriamo prima una breve 
descrizione poi uno spazio come separatore , poi il 
valore vero e proprio e in fine andiamo a capo tra- 
mite endl. Una volta scritti tutti i valori chiudiamo 
lo stream per applicare i cambiamenti. 



<6> IL RISULTATO 




Se tutto è andato per il verso giusto questo è il risul- 
tato della lettura stampato sulla console. 
Graficamente non entusiasmante ma efficiente. 
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Nascondere la traybar 



A volte potremmo sentire 
la necessità di dovere 
nascondere la traybar. 
È il caso tipico di applica- 
zioni che devono essere 
residenti nel sistema e con- 
tinuare a svolgere il loro 
compito senza ingombrare 
il desktop dell'utente. 
Ad esempio potremmo 



decidere di nasconderla per 
impedire all'utente di acce- 
dere al menu avvio oppure 
alla lista dei programmi 
aperti. Potrebbe anche 
accadere di voler nascon- 
dere la Tray Bar per sosti- 
tuirla con una diversa. 
Nell'esempio riportato di 
seguito andremo a vedere 



come ottenere nascondere 
o rendere visibile la tray 
bar in modo molto sempli- 
ce utilizzando soltando le 
API di Windows e un po' di 
C++; All'inizio del nostro 
programma andremo a veri- 
ficare se la tray bar è visi- 
bile, se lo è la nascondia- 
mo altrimenti la rendiamo 



visibile, il tutto è veramen- 
te semplice. Ciò di cui 
abbiamo bisogno è un com- 
pilatore c++, un editor di 
testo e un po' di dimesti- 
chezza con c++. Per realiz- 
zare il seguente esempio 
abbiamo utilizzato il classi- 
co Dev-C++ 

Stefano Vena 



CREARE UN NUOVO 
PROGETTO CONSOLE 

pi™™ 




wwWidgets 
Fraine 



Descrizione: 
A console application (MSDOS window) 



— O pzio n i del P r o ge tt o: 
Nome: 



Nascondi_TrayBar 



OS 

□ Un 



<y Qk 



Per prima cosa lanciamo dev-c++, poi dal sottomenu 
Nuovo del menu File scegliamo la voce Progetto, poi 
scegliamo dalla sezione basicW tipo di progetto "Con- 
sole Application" diamo un nome al nostro lavoro e 
diamo \'ok. 



<4 NASCONDIAMO LA BARRA 

if( isVisible ) 

{ 

SetWindowPos(hWnd, 0, 0, 0, 0, 0, 

SWP.HIDEWINDOW); 



cout « "Nascondo la TrayBar...\n"; 



> 



Prima d'ogni cosa andiamo a controllare lo stato 
della variabile isVisible, se essa ha come valore 
true allora la barra è visibile quindi procediamo 
a nasconderla tramite la chiamata a SetWindow- 
Pos. I parametri di tale funzione vanno impostati 
tutti a zero escluso il primo, il quale punta allo 
handle ottenuto in precedenza, ed il sesto che cor- 
risponde al flag necessario per nascondere la bar- 
ra. A questo punto la tray bar viene nascosta e 
non è più accessibile dall'utente. Le istruzioni 
per realizzare quanto proposto si riducono a 
pochissime righe di codice e non nascondono 
elementi di particolari complessità. L'unica 
accortezza è controllare i parametri di 
SetWindowsPos 



LE PRIME RIGHE 
DI CODICE 



ttinclude <iostream> 



Binclude <stdlib.h> 

Binclude <windows,h> 

usinq namespace std; 

int mairi ( int argc, char *argv[] ) { 

Il progetto contiene già un file con un semplice un 
programma c++, frutto degli schemi proposti dal- 
l'ambiente di sviluppo. Precisamente sono presenti 
due inclusioni <iostream> e <stdlib.h> ed una 
semplice implemenzione di main. Aggiungiamo 
l'header <window.h> e questo è sufficiente per 
andare al passo successivo. 



<5 VISUALIZZIAMO LA BARRA 

else 

{ 

SetWindowPosfliWnd, 0, 0, 0, 0, 0, 

5WP.SH0WWIND0W); 

cout « "Rendo visibile la TrayBar...\n"; 
} 

Se la variabile isVisible ha come valore false al- 
lora entriamo nella sequenza di funzioni di "el- 
se". Ciò vuol dire che la barra è nascosta quindi 
andiamo a renderla visibile. 
Per fare ciò ci serviamo nuovamente della fun- 
zione SetWindowPos ma al posto del flag SWP_ 
HIDEWINDOW andiamo ad utilizzare SWP_ 
SHOWWINDOW. Ora la barra è nuovamente visibi- 
le! Queste poche righe di codice sono molto 
potenti ma pericolose se non si presta attenzio- 
ne. Infatti potremmo inserire, in un nostro pro- 
gramma, il codice necessario a nascondere la 
barra ma non quello per renderla nuovamente 
visibile costringendo l'utente al riavvio del siste- 
ma. Un classico BUG da cattiva programmazio- 
ne, difficile da individuare a meno che non sia 
previsto il controllo da parte del programma 



3> DICHIARAZIONE 
DELLE VARIABILI 

BOOL isVisible = FALSE; 

HWND hWnd = NULL; 



hWnd = FindWindow("Shell_traywnd", "'■); 

isVisible = IsWindowVisible(hWnd); 

Le variabili necessarie sono due: una variabile di 
tipo HWND che riceve il valore dello handle asso- 
ciato alla tray bar ed un valore booleano, utiliz- 
zato come flag e indica se la barra è attualmen- 
te visibile oppure se è nascosta. 
Una volta dichiarate, le due variabili vengono 
settate. Per prima cosa otteniamo l'handle della 
barra attraverso la funzione FindWìndowe lo as- 
segniamo alla variabile hWndpoì verifichiamo lo 
stato della barra (visibile/nascosto) attraverso 
la funzione IsWindowVisible. 
Una volta ottenuta questa informazione siamo 
pronti per lo step successivo. 



<6> IL PRIMA E IL DOPO 
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Dopo la prima esecuzione del nostro codice la barra 
scompare. 



Rendo visibile la TrayBar... 

Prenere un tasto per continuare . . . _ 

I 


<i 
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\t(l startj 


=> a «* # H u * © « rj 





Ora la barra è nascosta per visualizzarla nuovamente 
eseguiamo di nuovo il nostro codice e per magia la 
barra ritorna! 
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Realizzare un f orm circolare 



Sei stanco dei soliti form 
quadrati? Allora questo è 
l'express che fa per te! 
Vedremo come è semplice 
ritagliare un form in Visual 
Basic 6 utilizzando solo due 
API di Windows un vettore di 
punti ed un po' di fantasia. 
Benché questo esempio sia 
riportato in visual basic esso 



può essere riadattato a qual- 
siasi linguaggio di program- 
mazione che abbia la possi- 
bilità di eseguire codice 
legato a API di Windows. 
Il codice gira sotto ogni piat- 
taforma microsoft dal Win- 
dows 95 in poi. 
Gli unici requisiti richiesti 
sono un po' di dimestichezza 



con l'ambiente VB6, il VB6 
stesso e una discreta cono- 
scenza delle API di sistema. 
Isoleremo una funzione rita- 
glia all'interno della quale 
definiremo per mezzo di una 
funzione la forma che desi- 
deriamo fare apparire sul 
video. Questa form verrà uti- 
lizzata come una sorta di 



maschera che coprendo una 
form classica simulerà una 
finestra di forma circolare. 
Ovviamente è sufficiente 
modificare questa funzione 
con i valori che riterrete più 
opportuni per ottenere effetti 
anche complessi. Tutto quel- 
lo di cui avete bisogno è VB6 
Stefano Vena 



ti > CREARE UN NUOVO 
PROGETTO 



P 



nsi 



■un 

New | Evfsting | Recent | 



soft 



«\ 



Don't show this dialog in the future 



Per prima cosa lanciamo VB6 nel wizard scegliamo il 
template "Standard exe" e poi scegliamo ok 



< 4 LA FUNZIONE RITAGLIA: 
INIZIALIZZAZIONE 

Me.ScaleMode = vbPixels 
Me.BackColor = vbYellow 

Me.Width = 300 * Screen.TwipsPerPixelX 

Me.Height = 300 * Screen.TwipsPerPixelY 
centroX = Me.ScaleWidth / 2 

centroY = Me.ScaleHeiqht / 2 

ReDim pts(0 To lati) 



For i = To lati 

pts(i).x = centroX + 100 * _ 

Cos(6.28 * i / lati) 

pts(i).y = centroY + 100 * . 

Sin(6.28 * i / lati) 

Nexti 

Dopo aver dichiarato la variabile andiamo a prepa- 
rare il form per essere ritagliato. 
Innanzitutto andiamo a settare lo ScaleMode su vb- 
Pixels poi impostiamo il colore di sfondo sul giallo. 
A questo punto andiamo a ridimensionare il form 
(questa volta in twips) ricaviamo il centro del form 
e andiamo avanti. Gli ultimi passi da fare sono ridi- 
mensionare il vettore di POINTAPI e riempirlo con le 
coordinate di una circonferenza. 



<2 LE API DI SUPPORTO 

Private Declare Function SetWindowRgn Lib "user32" 
(ByVal Hwnd As Long, ByVal hRgn As Long, ByVal 

bRedraw As Boolean) As Long 

Private Declare Function CreatePolygonRgn Lib 
"gdi32" (IpPoint As POINTAPI, ByVal nCount As Long, 
ByVal nPolyFillMode As Long) As Long 

Const WINDING = 2 

Private Type POINTAPI 

x As Long 

y As Long 
End Type 

Facciamo doppio click sul form di default al centro del- 
l'ambiente di sviluppo e accediamo al codice. Nella 
zona di intestazione del form (nelle prime righe in alto) 
andiamo ad inserire le dichiarazioni delle funzioni ester- 
ne importate dalle librerie del sistema. Ne nostro caso 
dichiareremo SetWindowRgn e CreatePolygonRgn inol- 
tre vanno dichiarate una costante (WINDING) ed una 
struttura POINTAPI. Suddetta struttura verrà utilizzata 
per decidere le coordinate della circonferenza che rita- 
glierà il nostro form. 



LA FUNZIONE RITAGLIA: 
IL RITAGLIO 

rgn = CreatePolygonRgn(pts(Q), .lati + 1, .WINDING) 

Cali SetWindowRgn(Me.Hwnd, rgn, True) 

End Function 

Private Sub Form.LoadQ 

Ritaglia 20 

End Sub 

Private Sub Form.ClickQ 

Unload Me 

End Sub 

Tutte le funzioni dell'API di Windows sono state espor- 
tate dal linguaggio C. La gestione dei vettori è diffe- 
rente rispetto a VB6. È possibile passare per riferi- 
mento il primo elemento di un vettore senza incorrere 
in errori. La variabile lati punta all'indice superiore 
dell'array pts, viene passato alla funzione incremen- 
tato di un'unità. Invocheremo la funzione Ritaglia 
all'interno dell'evento Form Load. 



< 3 JLA FUNZIONE RITAGLIA: 
LE VARIABILI 

Private Function Ritaglia(ByVal lati As Integer) 



Dim ptsQ As POINTAPI 

Dim rgn As Long 
Dim i As Integer 

Dim centroX As Single 

Dim centroY As Single 

Ora andiamo a dichiarare una funzione privata che 
utilizzeremo per ritagliare il form. 
Dopo la segnatura della funzione dichiaramo le va- 
riabili che utilizzeremo, siamo pronti per andare al 
passo successivo. 



<6> OSSERVIAMO 
L'APPLICAZIONE IN ESECUZIONE 
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Come avete potuto notare ritagliare un form è un'ope- 
razione abbastanza semplice ora partendo da questo 
esempio sbizzarritevi con le vostre forme. Tutto quello 
a cui dovete porre attenzione è la definizione della 
funzione di ritaglio. È anche importante osservare 
come nella definizione del passo 5 abbiamo utilizzato 
l'evento click del mouse per distruggere la form e 
liberare in questo modo le risorse di sistema. Altra 
nota importante è relativa al passaggio dei dati per 
riferimento invece che per valori 
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Semplifichiamo le query 
usando le Viste 



L'interrogazione di un Data 
Base è una operazione 
estremamente frequente 
nella maggior parte delle 
applicazioni. 

Concettualmente, tale opera- 
zione è semplice: usando 
una sintassi standard (SQL) 
si richiedono ad un Data 
Base dei dati che, sempre 



utilizzando la stessa sintassi, 
possono essere filtrati, ordi- 
nati, aggregati ecc. 
Quando abbiamo a che fare 
con Data Base complessi 
però, la stringa di richiesta 
dei dati può diventare com- 
plessa ed il suo utilizzo nel 
codice dell'applicazione può 
essere svantaggioso. Se uti- 



lizziamo Microsoft Sql Server 
come Data Base, abbiamo 
uno strumento molto potente 
per semplificare le interroga- 
zioni: le viste. 
Una vista può essere intesa 
come una tabella virtuale 
che raccoglie dei dati e che 
può essere richiamata dalle 
nostre applicazioni come se 



fosse una tabella reale. Oltre 
a semplificare le interroga- 
zioni, una vista ci permette 
in di astrarci dalla base dati 
in modo da non dover modi- 
ficare la nostra applicazione 
se cambia la struttura del 
DB. II che è un'ottimizzazio- 
ne non da poco. 

Michele Locuratolo 
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Apriamo Enterprise Manager (il tool di gestione di Sql 
Server), selezioniamo il Data Base di esempio 
Northwind e scegliamo il nodo Views 



<4 ESEGUIAMO LA VISTA 




Proviamo ora ad eseguire la nostra vista per verifica- 
re se il risultato è quello che ci aspettavamo. Per farlo 
clicchiamo sul punto esclamativo (!) rosso dell'editor 
ed analizziamo il risultato in basso. Se tutto è corret- 
to, salviamo la Vista con il nome vOrdini e chiudiamo 
l'editor. Siamo pronti per il prossimo passo. 



<2 UNA NUOVA VISTA 
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<3> QUALI TABELLE? 



Clicchiamo con il tasto destro del mouse su Views e 
scegliamo New View. Verrà aperto l'apposito editor in 
cui possiamo creare la nostra vista. Clicchiamo quin- 
di con il tasto destro del mouse in un area vuota del- 
l'editor e scegliamo la voce "Add Tables" 



< 5 FACCIAMO UN TEST 
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Per testare la vista come se la stessimo eseguendo 
dalla nostra applicazione, avviamo il Query Analyzer. 
Un altro tool fornito insieme a Sql Server per inviare 
comandi al nostro Data Base. 




Selezioniamo le tabelle di cui vogliamo recuperare i 
dati ed aggiungiamole all'editor con un doppio click. 
Una volta inserite le tabelle, selezioniamo i singoli 
campi che ci interesserà mostrare come risultato. 
Verrà creata una query uguale a quella che avremmo 
dovuto scrivere nel codice della nostra 



<6> IL RISULTATO FINALE 
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Recuperiamo i dati dalla nostra vista con la sempli- 
ce stringa: "Select * from vOrdini" al posto di quella 
più complessa visibile in Fig. 3. Oltre a questo signi- 
ficativo vantaggio sintattico, se dovesse cambiare 
qualcosa nelle tabelle che compongono la vista, sarà 
sufficiente modificare essa e non la nostra applica- 
zione. II gioco è fatto! 
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6 TOP UTILITY \ 

■ SNIPPET COMPILER 2 
REGULATOR2.QJ 

■ NDOC 

■ NANT 

■ NUNIT 

» WINMERGE2 2.2 



Apache 1. 3.33/2. 0. 53 

Il Web Server più usato al 
mondo 

Le due versioni del Web Server proget- 
tato da Apache che da solo tiene in 
piedi una buona parte di Internet. No- 
nostante l'agguerrita concorrenza 
Apache rimane un web server incredi- 
bilmente usato. I suoi moduli sono 
praticamente illimitati, è estrema- 
mente leggero, viene utilizzato prati- 
camente su tutte le piattaforme di 
Hosting del mondo. Se avete in mente 
di progettare un'applicazione Web 
non potete fare a meno di avere instal- 
lato sulla vostra macchina in locale 
una versione di Apache. La 1.3.33 è 
stabilissima ed è consigliata in abbi- 
namento ad esempio a PHP, la 2.0.53 
pur essendo ormai consolidata, rima- 
ne una versione da usare con cautela. 
Directory: /Apache 



Dadabik 3.2 

Un creatore di interfacce 
verso database 

Si tratta di una Web Application scrit- 
ta in PHP che consente di costruire 
altre Web Application basate su data- 
base. 



DaDaBIK 3.0 Beta 

Search for recorcls 




Ad esempio se volete costruire un sito 
web che esponga un catalogo multi- 
mediale, non vi resta che informare 
DadaBik di quali campi si compone il 



catalogo in questione, di quali fun- 
zionalità volete che il vostro sito sia 
dotato, e lasciare a DadaBik il compi- 
to di generare la vostra interfaccia. 
Non è necessario avere competenze 
estese di programmazione, l'uso di 
DadaBik è piuttosto semplice 
Directory: /DadaBik 

wxWidgets 2.4.2 

Comode librerie per lo sviluppo 
di interfacce grafiche 

Interessantissime queste librerie, più 
volte le abbiamo utilizzate all'interno 
dei nostri programmi per realizzare 
degli esempi. Si tratta di librerie che 
consentono la creazione di interfacce 
grafiche, possono essere utilizzate da 
C++ ma anche da altri linguaggi come 
ad esempio Python. La cosa estrema- 
mente interessante è che consentono 
lo sviluppo di applicazioni completa- 



Snippet Compiler 2 

Per compilare un piccolo pezzo di codice 



Un utility che consente di 
scrivere, compilare e far 
girare piccoli spezzoni di 



codice. Molto utile se si 
vuole provare il funziona- 
mento di una porzione di 



codice senza per questo 
voler creare un completo 
progetto con Visual Stu- 



dio prima di eseguire il 
tutto. 
Directory /SnippetCompiler 




□ Digita il codice che vuoi compilare 
all'interno della finestra principale 
dello snippet compiler. In ogni caso 
avrai a disposizione la sintax highligh- 
ting e la code complection 



Q Quando sei pronto, avvia una 
sezione di debug utilizzando il 
menu Debug, oppure scegli un'opzione 
come "Build" per compilare il tuo codi- 
ce velocemente 




HPer fare partire il programma, 
puoi utilizzare il classico tasto 
"start". La sezione di output verrà 
mostrata in basso nella finestra apposi- 
ta come in figura 
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Winmerge 2 2.2 

Per non trovarsi mai di fronte a versioni di codice differenti 



Un tool che vi consente di 
paragonare due file e tro- 
varne eventualmente le 
differenze. Utilissimo tutte 



quelle volte che avete 
apportato delle modifiche, 
ma non vi ricordate più 
qual è la versione più 



recente o esattamente cosa 
avete cambiato. Si tratta di 
una di quelle utility che 
non rivoluzionano la vita, 



ma che sicuramente con- 
tribuiscono a semplificare 
la routine giornaliera 

Directory /WinMerge 
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ODal menu file, scegli apri. Apparirà 
una dialog box in cui inserire i 
dati relativi ai due file da comparare. 
Scegli il primo utilizzando il tasto sfo- 
glia relativo a "sinistra" e il secondo 
utilizzando il tasto sfoglia relativo a 
"destra". 



HI due file verranno mostrati rispet- 
tivamente nei due riquadri propo- 
sti da winmerge. Le differenze nelle cor- 
rispettive righe saranno evidenziate con 
un colore giallo. Sarà possibile eviden- 
ziarle ulteriormente facendo doppio 
click sul testo da controllare. 
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H Apporta tutte le modifiche che ri- 
tieni necessarie, se è il caso il me- 
nu unisci ti darà una mano. Quando hai 
finito puoi creare una patch automatica 
oppure salvare direttamente uno dei 
due file con le modifiche effettuate. Op- 
pure tornare alla versione precedente. 



mente multipiattaforma, sono dispo- 
nibili infatti sia in ambiente *nix che 
in ambiente Windows. 
Continueremo sicuramente a par- 
larne in modo intensivo da queste 
pagine. 
Directory: /WxWidgets 

DevCPP 4.9.9.2 

La versione più recente 
dell'ambiente più usato 
dai programmatori C++ 

Dev C++ è pratico, non ha costi, è 
molto funzionale leggere e versatile, 
questo lo rende un tool estremamen- 
te amato dai programmatori C++ e 
che si contrappone nella sua sempli- 
cità a strumenti ben più costosi. 




programmazione come il sintax 
highliting e il code complexion, ma 
soprattutto è un'indispensabile se 
ritenete di volere o dover program- 
mare in C++ 
Directory: /DevCPP 

PHP 5.0.4 

Uno dei linguaggi principe 
per il Web 

Se seguite ioProgrammo o più sem- 
plicemente siete dei programmatori 
Web, o ancora molto più semplice- 
mente navigate su Internet, non 
potete non sapere che cosa è PHP. Si 
tratta del linguaggio con il quale 
sono sviluppate la maggior parte 
delle applicazioni internet esistenti. 




È ovviamente dotato di tutte le fun- 
zionalità tipiche di un ambiente di 



Quasi tutto il software per il web si 
regge su PHP. La curva di apprendi- 
mento è bassissima, le funzionalità 
esposte elevatissime, certamente se 
avete intenzione di sviluppare per il 



web non potrete fare a meno di pro- 
vare anche questo linguaggio come 
base per le vostre applicazione 
Directory /PHP 

SquirrelMail 

La capostipite delle WebMail 

Scritta interamente in Perl si tratta di 
un'applicazione che consente di leg- 
gere la posta direttamente da una 
comoda interfaccia Web. In realtà si 
tratta quasi della prima applicazione 
che è stata costruita con questo 
obiettivo, e se non si può dire che sia 
stato merito di SquirrelMail se si è 
diffusa su internet questa tendenza, 
possiamo affermare che nel dirlo non 
diciamo una cosa troppo lontana 
dalla verità. 

SquirrelMail è dotata di un gran 
numero di Plugin e l'unico appunto 
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che gli si può muovere è quello di non 
essere efficace dal punto di vista delle 
possibilità di personalizzazione del- 
l'interfaccia, inoltre non è multino - 
ming, nonostante questo è tuttavia 
una scelta quasi obbligata per chi 
vuole esporre funzionalità di webmail 
sul proprio sito. 
Directory /SquirrelMail 

STRUTS 1.2.4 

Il FrameWork per costruire 
applicazioni conformi all'MVC 

Di Struts ci siamo occupati più di una 
volta dalle pagine di ioProgrammo. 
Anche del patter Model View Control- 
ler abbiamo più volte discusso. Il pat- 
tern MVC stabilisce delle regoli tali 
che la logica di interfaccia, la logica di 
modello e quella di programmazione 
di un'applicazione siano completa- 
mente separate. Struts è un frame- 
work piuttosto solido che consente di 
creare applicazioni Web conformi allo 
standard MVC utilizzando Java e JSP 
Directory /Struts 

SharpDevelop 1.0.3 

L'ambiente alternativo 
per la programmazione C# 

Per chi non vuole affrontare i costi di 
Visual Studio.NET, per chi comunque 
vuole disporre di un ambiente abba- 
stanza leggero per potere program- 
mare le proprie applicazioni utiliz- 
zando C#, SharpDevelop sembra es- 
sere l'unica alternativa. 




Da poco è possibile utilizzarlo anche 
per programmare in VB.NET, tuttavia 
la sua caratterizzazione è rivolta pre- 
valentemente a C#. Si tratta di un pro- 
dotto ormai consolidato, rapido, vi- 
suale, economico e semplice da 
usare, alternativo a Visual Studio 
Directory /SharpDevelop 



PHPEclipse 1.1.3 

Un plugin per usare Eclipse 
come ambiente di 
programmazione 
per PHP 




Molti di voi conosceranno Eclipse, si 
tratta dell'ambiente "tuttofare" con 
cui è ormai possibile programmare 
qualunque tipo di linguaggio o quasi. 
Pur essendo fortemente orientato 
verso Java, Eclipse è estendibile tra- 
mite Plugin per essere utilizzato per 
diversi scopi. Il plugin che qui vi pre- 
sentiamo estende Eclipse al fine di 
potere utilizzarlo per programmare 
applicazioni PHP 
Directory /PHPEclipse 

Eclipse 3.0.2 

La nuovissima versione 
dell'ambiente di 

programmazione più innovativo 
del momento 

Eclipse rappresenta uno dei maggiori 
punti di rottura con la concezione 
tradizionale di "IDE". Mentre fino ad 
ora la maggior parte degli IDE con- 
centravano le proprie funzionalità 
per essere un supporto a un unico lin- 
guaggio, eclipse si configura come un 
ambiente aperto estendibile tramite 
plugin. 




Questo garantisce che comportamen- 
ti simili attribuibili all'ambiente siano 
condivisi da più linguaggi di pro- 
grammazione. In questo modo si ab- 
braccia l'idea che il moderno pro- 
grammatore debba essere in grado 



comunque di conoscere più di una 
tecnica e saperla utilizzare al mo- 
mento giusto. Eclipse è il tool ottima- 
le per supportare questa idea. 
Directory /Eclipse 

PircBot 1.4.4 

Un bot ire programmabile in 
Java 

Interessante questa idea di fornire 
agli amanti di IRC una serie di API che 
gli consentono di programmare un 
bot utilizzando JAVA. 
Normalmente chi si dedica a questo 
tipo di applicazioni utilizza Eggdrop e 
programma in TCL, in tutti e due i 
casi non si tratta di tecniche di larga 
diffusione, viceversa Java è un lin- 
guaggio che gode di un'immensa 
popolarità, per cui il poter program- 
mare dei Bot attraverso la flessibilità 
di java rappresenta senza dubbio 
un'opportunità interessante 
Directory /PircBot 

DevPHP 

Un IDE leggerissimo 
per programmare PHP 

Scritto sotto licenza GPL e perciò de- 
cisamente gratuito, DEVPhp è uno dei 
tanti fiori all'occhiello del mondo 
OpenSource. 
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Leggerissimo, ma completo, dotato di 
tutte le funzionalità tipiche di un IDE 
di alto livello, si pone come una scel- 
ta interessantissima per chi vuole 
programmare in PHP avendo a dispo- 
sizione il comodo supporto del Syn- 
tax Highlighting, del code comple- 
xion, della gestione del file system e 

così via 
Directory /DevPHP 

Tomcat 5.5.9 

L'application Server per JSP 

Se siete dei programmatori JSP o 
aspirate a diventarlo, il vostro appli- 
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cation Server di riferimento è sicura- 
mente Tomcat. 

Giunto alla sua versione 5.5.9 è ormai 
da considerarsi decisamente un pun- 
to di riferimento per quanti utilizzano 
queste tecnologie per lo sviluppo di 
applicazioni Web. Non è certo un mo- 
stro di leggerezza, o un esempio di 
semplicità d'utilizzo, tuttavia è sicu- 
ramente una strada obbligata per 
programmare in JSP 
Directory /Tomcat 

Thinlet 

Le API per creare interfacce 
usando XML 

Ne parliamo diffusamente in questo 
stesso numero di ioProgrammo, con 
un bell'articolo di Daniele de Miche- 
lis. Le Thinlet sono un set di API che 
consente di definire in comodi file 
XML delle interfacce grafiche per ap- 
plicazioni Java. È altrettanto semplice 
richiamare i file in questione dal co- 
dice Java, programmare gli eventi che 
corrispondono ad azioni compiute su 
bottoni e pannelli e tenere in questo 
modo separate la logica di program- 
mazione da quella di definizione del- 
l'interfaccia. L'utilizzo di XML per la 
definizione dell'aspetto dell'applica- 
zione è decisamente interessante, se 
si pensa alla comodità di dover agire 
su semplici file di testo. 
Directory /Thinlet 

Hibernate 3.0 

Il tool per la persistenza dei dati 
in JAVA 

I programmatori sono abituati a pen- 
sare in termini di classi ed oggetti. 
Non c'è programma che prescinda or- 
mai dalla logica della programmazio- 
ne OOP. Tuttavia i database SQL 
ragionano ancora in termini di puro 
linguaggio, non c'è nessuna correla- 
zione fra un dato e l'oggetto che lo 
rappresenta. Hibernate aggira questo 
ostacolo, ponendosi come framework 
che maschera un database relaziona- 
le con una logica OOP. 
In questo modo i programmatori Java 
possono ad esempio accedere a un 
qualunque database pensando alle ri- 
ghe e alle colonne che lo rappresenta- 
no in termini di oggetti e non di entità 
relazionali. 
Directory: /Hibernate 



Ultimate ++ 

L'IDE più innovativo per C++ 

Se DEV C++ rappresenta ormai uno 
standard per i programmatori C++, 
Ultimate ++ si sta dimostrando un'ot- 
tima alternativa. Leggero, veloce, do- 
tato di alcune estensioni che lo ren- 
dono in parte RAD, viene distribuito 
con il compilatore MinGW. 
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È dotato naturalmente di tutte le ca- 
ratteristiche di un buon IDE, tuttavia 
dispone di un'organizzazione che la- 
scia rapidamente intendere che da 
questo ambiente dovremo attenderci 
delle grosse novità nel futuro, sia in 
termini di prestazioni che di comple- 
tezza 
Directory /Ultimatepp 

Lazarus 0.9.6 

Il clone Freeware di Delphi 

Delphi è stato il capostipite dei 
moderni ambienti RAD e forse quello 
che meglio di ogni altro ha interpreta- 
to e continua a interpretare il senso 
della programmazione RAD. Il lin- 
guaggio che sta al di sotto di Delphi è 
l'Object Pascal che purtroppo però 
non ha mai incontrato il favore dei 
programmatori. 




Le ragioni di questa poco affetto nei 
confronti dell'Object Pascal sono sto- 
riche prima e di marketink commer- 
ciale dopo, tuttavia Delphi è e rimane 
un tool RAD estremamente sofistica- 



to adatto alla creazione di applicazio- 
ni di ampio respiro ed estremamente 
professionali. Lazarus è il clone FREE 
di Delphi. Se pur non è dotato di tutte 
i raffinati meccanismi che fanno del 
Delphi attuale lo straordinario stru- 
mento che è, lazarus è comunque un 
tool efficacissimo che da un lato 
interpreta la logica della programma- 
zione RAD ai massimi livelli, dall'altro 
consente di programmare a oggetti 
utilizzando Object Pascal che a sua 
volta è e rimane uno dei migliori lin- 
guaggi per la OOP. 
Directory /lazarus 

Drupal 4.6.0 

Il principe delle piattaforme 
di Blogging 

I Blog sono stati il fenomeno dell'ulti- 
mo anno. Non c'è persona che abbia 
un minimo di feeling con internet che 
non disponga del proprio Blog dove 
esporre i propri interessi o semplice- 
mente annotare qualche pensiero. 
Drupal è attualmente una delle piat- 
taforme per la costruzione di Blog 
maggiormente diffusa. Da notare che 
abbiamo usato il termine: "piattafor- 
ma" di fatto Drupal consente di riuni- 
re sotto un'unica applicazione molti 
blog. 
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Drupal 4.6.0 relsased 



Ogni utente registrato di un sistema 
Drupal diventa infatti un possessore 
di Blog. Dispone di strumenti tali da 
poter pubblicare rapidamente conte- 
nuti personalizzati. Questa nuova 
versione è finalmente compatibile 
con PHP 5.0, sono state infine miglio- 
rate le funzioni che consentono di 
personalizzare maggiormente i singo- 
li Blog. Rimangono invariate le già 
ottime funzioni per la creazione di 
moduli personalizzati. Nel complesso 
un buon tool. 
Directory /Drupal 
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PHP Java Bridge 

Il ponte fra Java e PHP 

Ne parliamo in questo stesso numero 
di ioProgrammo. Si tratta del software 
che consente di utilizzare classi Java 
direttamente da PHP. In questo modo 
è abbastanza semplice per un pro- 
grammatore Java costruire le proprie 
classi e poi riutilizzarle anche sul 
web. Ad esempio una classe per il cal- 
colo dei numeri primi compresi in un 
certo range, deve essere semplice- 
mente richiamata da PHP per poter 
funzionare, ma analogamente funzio- 
nerà senza problemi anche in un 
ambiente standalone. Si tratta di un 
tool da provare sia per i programma- 
tori PHP che per quelli Java, non 
mancate di leggere l'articolo qui pro- 
posto 
Directory /PHPJavaBridge 

Python 2.4.1. 

Il linguaggio emergente 

Un linguaggio di scripting, multipiat- 
taforma, orientato agli oggetti. Tre 
caratteristiche che rendono questo 
linguaggio piuttosto appetibile. Non 
per niente tutte le classifiche mon- 



diali sulla diffusione dei linguaggi di 
programmazione lo individuano 
come quello maggiormente in ascesa. 
Python è elegante, estensibile, con 
una curva di apprendimento non ele- 
vatissima. Viene utilizzato per pro- 
grammare moltissimi tool di gestione 
dei sistemi Unix, ma sta trovando una 
rapida applicazione anche sui sistemi 
Windows e nello sviluppo di applica- 
zioni crossplatform. 
Directory /Python 

Ivlysql 4.1.11 - Beta 
5.6.3 

Uno dei DB server più usati al 
mondo 
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Se Apache e PHP fanno da supporto 
alla maggior parte delle applicazioni 



che girano oggi su Internet, è anche 
vero che quasi tutte queste applica- 
zioni sfruttano almeno in parte un 
database MySQL come sostegno per 
conservare i dati che manipolano. 
MySQL è estremamente leggero, velo- 
ce, flessibile, inoltre è multipiattafor- 
ma. Offre caratteristiche di tutto ri- 
spetto, che vanno dal supporto alle 
transazione alla ricerca full text, è 
perfettamente integrato con PHP. Tut- 
te queste ragioni ne hanno fatto un 
leader per quanto riguarda il settore 
dei database. In questo numero oltre 
alla versione 4.1.11 ormai consolidata 
vi presentiamo anche la nuovissima 
Beta 5.0.3 da non utilizzare in am- 
bienti di produzione, ma piuttosto in- 
trigante per capire da soli qual è la di- 
rezione che uno dei database più usa- 
ti al mondo sta usando. 
Directory /MySQL 

Mono 1.6.0 

Programmare in tecnologia .NET 
su tutte le piattaforme 

Ce ne parla estensivamente Alessan- 
dro la Cava in questo stesso numero 
di ioProgrammo. Mono è la versione 



MEDIAWIK1 1.4.0 

L'applicazione preferita per la creazione di documenti 



Riproponiamo MediaWiki 
ormai da qualche numero. 
Lo facciamo perché real- 
mente crediamo che si 
tratti di uno di quei 
software utilissimi per un 
programmatore o per chi 
scrive la documentazione 



relativa a un software. Di 
fatto è ormai uno stan- 
dard, si tratta per esempio 
dell'applicazione che fa da 
substrato a wikipedia. Ma 
in realtà trovate un wiki in 
quasi ogni sito che fa da 
supporto a un software. 



Per quelli che ancora non 
lo sapessero si tratta di 
un'applicazione che con- 
sente di scrivere documen- 
tazione in modo collabora- 
tivo e multimediale. 
Le pagine vengono create 
semplicemente puntando il 



browser su contenuti che 
non esistono fino a quel 
momento e i link vengono 
aggiornati in modo dina- 
mico. 

Directory /MediaWiki 
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TutorialMediaWiki 






Punta il browser su un link inesi- 
stente. Assicurati che l'uri da te 

inventato abbia un titolo significativo. 

Ti apparirà una pagina che ti avverte 

che la pagina non esiste e ti chiede se 

vuoi crearla. 
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Scrivi il tuo articolo utilizzando la 
sintassi classica del Wiki. Puoi aiu- 
tarti con uno dei bottoni della maschera 
di edit. Nell'esempio abbiamo utilizzato 
il marcatore {{category:tutorìa}} per 
indicare una categoria. 



H Clicca sul bottone salva la pagina. 
Il risultato sarà una pagina format- 
tata secondo un layout corretto, inoltre 
a fondo pagina comparirà l'elenco delle 
categorie di appartenenza così come le 
abbiamo indicate nella maschera di edit. 
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OpenSource della piattaforma .NET. 
Ha dalla sua parte la possibilità di gi- 
rare in multipiattaforma, per cui se 
scrivere un'applicazione C# compati- 
bile Mono in ambiente Windows avre- 
te la certezza che la stessa versione 
funzioni anche in ambiente Linux. 
Non è certo una caratteristica da po- 
co se pensate alla possibilità di utiliz- 
zare le tecniche che meglio conoscete 
svincolando i clienti dalla necessità di 
dover investire verso un sistema piut- 
tosto che un altro. 
Directory /Mono 

Irrlicht 0.9 

L'attesissima nuova versione del 
motore 3D più in voga del 
momento 

Di irrlicht abbiamo parlato tantissi- 
mo negli scorsi numeri di ioProgram- 
mo. La serie condotta da Alfredo Mar- 
roccelli su queste stesse pagine è sta- 
ta una delle più apprezzate degli ulti- 
mi numeri. 




Si tratta di un engine 3D molto legge- 
ro e facile da usare, viene utilizzato da 
C++ è compatibile con OpenGL e 
DirectX ed è estremamente flessibile. 
Si tratta di un must per i programma- 
tori di VideoGames o per chi aspira a 
diventarlo. 
Directory /irrlicht 

Icecast 2.2.0 

Il server di streaming 

Non è la prima volta che vi proponia- 
mo questo server, tuttavia la grande 
diffusione che le radio online stanno 
attraversando ci convince che sia un 
tool da tenere in considerazione. Si 
tratta di un server che prende in input 
da un encoder dei suoni e li proietta 
in streaming su internet pronti per 




essere ascoltati tramite ad esempio 
WinAmp o Windows Media Player. 
È la base della costruzione di una ra- 
dio online, o molto più semplicemen- 
te della diffusione della musica creata 
da voi su internet. 
Usatelo ovviamente per fini legali. 
Directory /Icecast 

EasyPHP 1.8 

Per installare un server PHP 
in modo semplice 

Molti di voi avranno provato ad avvi- 
cinarsi a PHP. Il primo passo solita- 
mente è creare un'installazione locale 
composta da Apache+PHP+MySQL, 
l'operazione non è complicata ma per 
chi è alle prime armi spesso si rivela 
un ostacolo insormontabile. EasyPHP 
è un tool che tramite pochi clic instal- 
lerà per voi un sistema completo 
adatto ad essere utilizzato come ser- 
ver di prova per le vostre applicazioni 
PHP, svincolandovi così dalle opera- 



zioni di installazione, che si addicono 
più a un sistemista che ad un pro- 
grammatore 
Directory /EasyPHP 

Jedit 4.2 

L'editor leggero 

per programmatori Java 

Realizzato completamente in Java, 
jEdit è un completo editor di testi per 
programmatori disponibile per nu- 
merose piattaforme tra cui MacOS X, 
OS/2, GNU/Linux (Unix) e Windows. 
Il programma, per l'immediatezza e 
la semplicità di utilizzo, è molto usato 
per scopi didattici e da programmato- 
ri non professionisti. 



jEdit integra un completo linguaggio 
di macro e dispone di un'architettura 
facilmente estensibile mediante l'uti- 
lizzo di numerosi plugin facilmente 
gestibili tramite il "plugin manager". 
Inoltre, nonostante sia stato creato 



SysLinux 3.0.7 



Per creare periferiche di installazione di linux 



Questo è realmente un 
software molto "stuzzi- 
cante" e che solletica la 
fantasia di ogni appas- 
sionato di informatica. 
Consente di creare 
dischetti di installazio- 
ne di linux. Utilizzare 
syslinux è davvero 
molto semplice. E' suf- 
ficiente copiare i file 
del kernel su un 
dischetto è poi usare 
syslinux da riga di 
comando per ottenere 
un disco bootable con 



Linux dentro. Nello 
stesso pacchetto ci 
sono anche isolinux e 
extlinux per creare 
CDRom bootable conte- 
nenti linux e addirittu- 
ra per creare una direc- 
tory bootable in rete da 
cui far partire il sistema 
operativo sfruttando le 
caratteristiche dei 
moderni bios. Ora tutto 
questo è veramente 
interessante. Potete ad 
esempio creare la 
vostra distribuzione. 



sfruttando ad esempio 
BusyBox, o creare una 
penna USB bootable, o 
utilizzare questo siste- 
ma per mettere linux su 
delle memory card che 
poi svolgano dei compi- 
ti specifici. 

Insomma le possibilità 
di applicazione sono 
veramente tante. 
È sufficiente un po' di 
fantasia per realizzare 
cose davvero utili e 
divertenti. 

Directory /SysLinux 
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per sviluppare prevalentemente 
applicazioni Java, dispone di funzio- 
nalità per indentare ed evidenziare il 
codice per oltre ottanta linguaggi di 
programmazione. Per poter installare 
e utilizzare jEdit è necessario disporre 

delJ2SDK1.3o 1.4. 
Directory /Jedit 

J2SE 1.5.0.2 

Il framework essenziale 
per programmare in Java 

Se siete dei programmatori java non 
potete prescindere dall'installare il 
JDK, si tratta del framework di base 
che contiene il compilatore, le utility 
e le librerie per potere iniziare a lavo- 
rare con Java. Quello che vi presentia- 
mo è il secondo aggiornamento della 
versione 1.5 rilasciato da brevissimo 
tempo e contenente alcune migliorie 
dal punto di vista della security e 
moltissimi Bug Fix che migliorano in 
linea generale l'usabilità e l'affidabi- 
lità del linguaggio 
Directory /J2SE 

Dia 0.94 

Crea diagrammi di flusso in 
modo semplice 

Molto spesso nella programmazione 
di un software, o anche semplice- 
mente neh' illustrare il ciclo di vita di 
un'applicazione o di una situazione si 
fa ricorso a diagrammi di flusso. Uno 
dei leader indiscussi del mercato in 
questo settore è senza dubbio Visio di 
Microsoft. 
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quelle situazioni in cui è necessario 
generare un diagramma di flusso 
Directory /Dia 

James 2.2.0 

Il server di posta di Apache 

JAMES è l'acronimo anagrammato di 
Apache Java Enterprise Mailserver. Si 
tratta di un server SMTP, POP3 e 
NNTP interamente scritto in java. 
L'idea di base di Java è scrivere un 
mail server interamente portabile. 
L'utilizzo di Java in questo senso ha 
centrato completamente l'obiettivo. 
In questo numero di ioProgrammo 
abbiamo analizzato alcuni spezzoni 
del codice sorgente di James proprio 
per farci un'idea di come esso gestisca 
l'interazione con i server di Black List. 
Come si vede e come è classico del- 
l'OpenSource l'estrema portabilità e 
la disponibilità del codice sorgente 
sono i punti di forza di progetti di 
questo genere. 
Directory /James 

J2ME Polish 

Il costruttore di GUI per device 
mobile 




Dia non pretende di avere le stesse 
funzionalità di Visio e neanche la 
stessa complessità ma si pone come 
un software leggero diffuso sotto 
licenza OpenSource che può essere 
usato in modo conveniente in tutte 



J2ME Polish è forse un precursore dei 
tempi. Si tratta infatti di un software il 
cui scopo è supportare il programma- 
tore nella creazione di interfacce de- 
stinate a dispositivi portatili quali ad 
esempio cellulari o palmari. Ovvia- 
mente la base su cui si fonda è J2ME 
ormai onnipresente in qualsiasi ap- 
plicazione per dispositivi del genere, 
tuttavia invece la definizione dell'in- 
terfaccia basa le sue caratteristiche su 
semplici file HTML un po' come ab- 
biamo visto fare a thinlet in questo 
stesso numero di ioProgrammo. Inte- 
ressante è anche il fatto che J2MEPo- 
lish sia distribuito sotto licenza GPL. 
Directory /J2MEPolish 



lnstaller2Go 

Un sistema facile e gratuito 
per realizzare pacchetti 
di installazione 

Un tool per la creazione di file autoin- 
stallanti che non impegna lo svilup- 
patore nel dover imparare l'ennesimo 
linguaggio di scripting: con una inter- 
faccia che punta tutto sul frag&drop, 
realizzare pacchetti di installazione 
diventa un vero gioco da ragazzi. 
Benché gratuito, Installer2Go va in- 
contro a tutte linee guida per la certi- 
ficazione WindowsXP. Versione dimo- 
strativa: alla fine di ogni istallazione 
si è rimandati ad una pagina pubbli- 
citaria che fa riferimento al produtto- 
re di Installer2Go. 
Directory /lnstaller2Go 

Firebird 1.5 

Un database evoluto 
e multipiattaforma 

Il motore del database Firebird è stato 
creato da un team indipendente di 
sviluppatori volontari partendo dal 
codice sorgente del database InterBa- 
se prodotto da Borland (allora Inpri- 
se) e distribuito con licenza IBL (In- 
terBase Public License) il 25 Luglio 
2000. Firebird è un database relazio- 
nale (RDBMS) che supporta in modo 
quasi completo lo standard ANSI 
SQL-92, ed è disponibile per sistemi 
GNU /Linux, Windows e può essere 
eseguito su una varietà di piattaforme 
UNIX. Inoltre, Firebird offre presta- 
zioni elevate e pieno supporto per 
stored procedures e triggers. 
Directory /Firebird 

XAMPP for 
Windows 1.4.13 

ServerWeb, FTP, DBMS, PHP e 
Perl tutto in uno 

Molti sviluppatori sanno, per espe- 
rienza personale, quanto sia difficile 
installare il server Web Apache e suc- 
cessivamente aggiungere e configura- 
re il supporto per PHP, MySQL, Perl o 
altro. L'obiettivo degli sviluppatori di 
XAMPP è quello di fornire agli svilup- 
patori un modo semplice e veloce per 
installare una piattaforma di sviluppo 
Web completa, che ruota attorno al 
server Web Apache (capostipite di 
questa tipologia di software è stato 
EasyPHP). Al momento sono disponi- 
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bili le versioni per GNU /Linux, Sola- 
ris e MS Windows. Quest'ultima, di- 
sponibile per i sistemi operativi Win- 
dows 98, NT, 2000 e XP, installa in un 
colpo solo Apache, MySQL, PHP più 
PEAR, Perl, mod_php, mod_perl, 
mod_ssl, OpenSSL, phpMyAdmin, 
Webalizer, Mercury Mail Transport 
System for Win32 and NetWare Sy- 
stems v3.32, JpGraph, FileZilla FTP 
Server, mcrypt, Turck MMCache, SQ- 
Lite, e WEB-DAV + mod_auth_mysql 
Directory /Xampp 

Mantis 0.19 

Ottima soluzione per la 
gestione dei Bug 

Potete stare certi che qualunque sia il 
numero di test effettuati prima di 
mettere un software in commercio, 
nel momento in cui avrà successo e 
sarà utilizzato dal grande pubblico 
verrete sommersi da indicazioni di 
Bug o richieste di nuove feature. 
Mantis è una web application che 
consente agli utenti registrati di indi- 
care un bug reperito nella vostra 
applicazione di modo che voi possia- 
te avere un comodo registro dei bug, e 
utilizzarlo per risolverli ed elaborare i 
fix in modo efficiente. 
Directory /Mantis 



SuperEdi 3.7 

Un editor piccolo e funzionale 
per gli sviluppatori 

Ideato appositamente per gli svilup- 
patori, SuperEdi può essere utilizzato 
sia per lo sviluppo in locale che per 
modificare file in remoto. 
Completamente gratuito, presenta 
tutte le principali funzionalità degli 
editor più blasonati: evidenziazione 
sintattica per i maggiori linguaggi, fil- 
tri per la manipolazione automatica 
del testo e supporto multilingua. 
Directory /Superedi 

Jasper Reports 0.6 

Risolve il problema dei reports 
in Java 

Molto probabilmente il framework 
più completo per generare dei reports 
in applicazioni Java. Ottime funzione 
di aggregazione e di generazione di 
grafici statistici. Non complicato dal 
punto di vista delle funzionalità, fino 
a qualche tempo fa mostrava ancora 
una qualche fragilità. La versione 0.6 
che vi presentiamo è invece sufficien- 
temente stabile e consente di genera- 
re report partendo da una base di dati 
e utilizzando classi Java senza avere 
troppi problemi 
Directory Alasperreports 



Spe 0.7.3 

L'editor per Python 

Molti di voi avranno cominciato ad 
apprezzare il linguaggio Python. Spe è 
un editor molto evoluto che vi con- 
sente di elaborare le vostre applica- 
zioni Python usufruendo del suppor- 
to alla syntax highliting e alla sintax 
completion. Si tratta di un ottimo edi- 
tor che aumenta di molto la vostra 
produttività se state utilizzando il lin- 
guaggio Python 
Directory /SpeEditor 

EMF 

Eclipse Modeling Framework 

Si stratta di un framework di modella- 
zione e di code generation che a par- 
tire da un modello XML fornisce clas- 
si Java in grado di operare su quel tipo 
di modello. 

Non è decisamente un tool semplice 
da utilizzare ma è un requisito essen- 
ziale per installare l'Eclipse Visual 
Editor che vi presentiamo in questo 
stesso numero di ioProgrammo. 
Directory /EMF 

Gef 

Graphical Editing Framework 

Consente agli sviluppatori di creare 
editor grafici a partire da un modello 



Regulator 2.0.3 

Per non avere problemi con le regular expression 



Le regular expression rap- 
presentano uno dei siste- 
mi più potenti che qua- 
lunque linguaggio porta 



in dotazione per i pro- 
grammatori. Vengono uti- 
lizzate per effettuare 
ricerche su testi o strin- 



ghe SQL, o per sostituire 
una stringa con un'altra e 
per molto altro ancora. 
Regulator è un tool per 



testare e costruire 
espressioni regolari in 
modo semplificato 

Directory /Regulator 
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Q Seleziona il file su cui vuoi applica- 
re le regular expression utilizzan- 
do il tasto "input" posto nel riquadro in 
basso a sinistra. Dopo averlo aperto il 
file in questione comparirà all'interno 
del riqaudro 
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QScrivi una regular expression nel 
riquadro superiore, utilizzando se 
vuoi la code complexion per aiutarti a 
digiare correttamente l'espressione 
regolare. Da notare che all'interno del 
tooltip compaiono spesso degli aiuti 
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H Quando avrai finito utilizza 
"match" oppure "replace" per 
testare la validità della tua regex. 
Utilizzando il tasto match, compariran- 
no nel riquadro di destra tutte le occo- 
renze dell'espressione ricercata 
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preesistente. Anche questo tool non è 
particolarmente semplice da utilizza- 
re in applicazioni di produzione ed 
anche in questo caso è però un requi- 
sito essenziale per installare l'ottimo 
plugin di eclipse: Visual Editor 
Directory /Gef 

Eclipse Visual Editor 

Per rendere Eclipse RAD 

Eclipse è probabilmente il tool più 
usato per programmare in Java. Ha 
dalla sua una serie di facilities che 
aiutano il programmatore a districar- 
si nella complicata gerarchia di classi 
offerta dal linguaggio. Manca ad 
Eclipse, forse , forse solo la possibilità 
di usufruire di un tool per la genera- 
zione visuale delle interfacce. Questa 
possibilità viene offerta ad eclipse da 
uno dei suoi Plugin più amati: il 
Visual Editor, tramite il quale si può 
appunto estendere eclipse affinché 
abbia la possibilità di progettare 
visualmente le interfacce grafiche 
delle applicazioni. 
Directory /Visual Editor 

PHPGroupware 
0.9.16 

Per la gestione di gruppi di 
lavoro 
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La normale gestione della produzione 
in un ambiente di lavoro richiede ai 
nostri tempi uno sforzo non indiffe- 
rente. La gestione dei tempi, la condi- 
visione delle informazione, la norma- 
lizzazione dei progetti sono tutte ope- 
razioni complesse che impegnano in- 
gegneri gestionali e manager. PHP- 
Groupware è un ottimo supporto alla 
gestione di un'attività di produzione. 
Si tratta di una web application da 
utilizzare in una intranet o anche da 
condividere fra uffici o rappresentan- 
ti geograficamente dislocati. Serve a 



coordinare l'attività di produzione a 
partire da una commessa fino alla 
consegna dei materiali, tenendo sotto 
controllo i costi e tutti gli altri para- 
metri che contribuiscono alla buona 
riuscita della produzione. 
Directory /PHPGroupware 

lUdoc 

Per creare facilmente codice 
documentato 

Creare codice ben documentato è 
ormai una necessità. Spesso e volen- 
tieri ci troviamo a lavorare con più 
mani sullo stesso codice, ed è impor- 
tante documentare classi e metodi 
affinché chiunque si trovi nelle con- 
dizioni di manipolare il codice possa 
farlo nella maniera migliore. Ndoc 
sfrutta la reflection per esaminare 
l'assembly generato dalle vostre 
applicazioni, estraendo i commenti 
che avete inserito e generando un file 
XML da sfruttare per generare la 
documentazione opportuna. 
Directory: /Ndoc 



PHTML Encoder 3.8 

Per criptare le vostre pagine 
PHP 

Avete necessità di proteggere i vostri 
script PHP da occhi indiscreti? Ecco a 
voi un enconder che vi consente di 
codificare i vostri script prima di 
distribuirli. Poiché la tecnica usata è 
relativa proprio a PHP, i vostri script 
codificati funzioneranno su ogni piat- 
taforma, sia Windows che Linux. 
Directory /PHTMLEncoder 

l\lotepad++ 2.9 

Editor per sviluppatori 

Notepad++ è un editor di codice per 
programmatori e un potente editor di 
testi per utenti comuni: leggero, ver- 
satile e altamente configurabile che 
integra numerosi algoritmi di codifica 
crittografica e alcuni utili tool. Il pro- 
gramma è realizzato interamente in 
C++, mentre i linguaggi supportati 
sono: C/C++, Java, HTML, XML, PHP, 
JavaScript, Visual Basic, Perl, Python, 
CSS e tanti altri. Notepad++ è distri- 
buito con licenza GNU GPL e alcune 
sue parti derivano dal progetto 

Scintilla. 
Directory: /Notepad 



Nant 

L'assemblatore di progetti 

Nant è un tool che consente di 
costruire un processo automatico per 
la generazione di applicazioni. Da 
utilizzare quando un prodotto è sud- 
diviso in molte dll o sottoprodotti 
gestiti da reparti separati, nant crea 
una specie di processo batch che rac- 
coglie i file dalle directory dei singoli 
sviluppatori, li compila e li predispo- 
ne per la costruzione di un'applica- 
zione completa 
Directory /nant 

Mrtg 2.11 

Per tenere sotto controllo il 
consumo delle risorse 
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Mrtg è una Web Application scritta in 
Perl che consente di visualizzare gra- 
ficamente il consumo delle risorse di 
una macchina prelevando le informa- 
zioni dal servizio SNMR Consente ad 
esempio di visualizzare il consumo di 
banda, il numero di accessi al web 
server, il numero di accessi FTP, o 
anche l'occupazione della memoria e 
l'utilizzo dell'Hard Disk. Si tratta di 
una web application molto utile 
soprattutto per chi fa hosting, ma 
anche per chi essendo ospitato su un 
server vuole conoscere esattamente 
le prestazioni della macchina su cui il 
proprio sito gira. 
Directory /mrtg 

Hlunit 

Il costruttore di test 

Qualche volta, anzi molto spesso vi 
troverete a costruire dei test per 
"stressare" la vostra applicazione 
.NET e vedere come reagisce. Nunit è 
un tool opensource che vi mette a 
disposizione un linguaggio per scri- 
vere procedure di test. Inoltre con- 
sente di visualizzare i risultati tramite 
un'interfaccia grafica. 
Directory /nunit 
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ARSIONE 



1 Network Server Monitor 

I servizi offerti via rete sono ormai tantissimi. GFI Network 
Server Monitor automatizza il controllo sulla Rete, e vi avverte 
se qualcosa non va 



GFI Network Server Monitor ver- 
sione 6 è uno di quei tool da rite- 
nersi indispensabili per la corretta 
gestione di un ambiente di rete. Do- 
cumentare completamente tutte le 
funzioni di cui dispone è compito di 
una guida dettagliata, per quello che 
ci riguarda è invece importante per 
porre l'accento su quella che è la sua 
funzione primaria, ovvero eseguire 
dei check ripetitivi a scadenze tempo- 
rali ben definite di tutti o parte dei 
servizi che compongono il network ed 
alertare con un qualunque modo, 
email, sms, alert un responsabile af- 
finché possa intervenire sul servizio 
ed eventualmente ripristinarlo. Ma 
cosa si intende per servizio di rete? Si 
intende tutto ciò che in un qualche 
modo espone delle funzionalità ai 
partecipanti di un network. 
Ad esempio è possibile controllare co- 
stantemente che il server web stia 
funzionando correttamente, o il dns, 
o il mail server e perché no il file ser- 



OTTENERE IL CODICE DI SBLOCCO 



GFI Network Server 



ioProgrammo trovate 



Monitor è un tool alta- una versione completa 
mente professionale. Il freeware valida per 



valore commerciale in 
licenza completa per 
tre server è di 250 €. 
In questo numero di 



trenta giorni. Per otte- 
nere gratuitamente la 
licenza per tre server 
dovete connettervi al 



sito http://www.qfi- 
italia.com/io e compila- 
re il modulo di richie- 
sta. Vi verrà inviato un 
codice che sblocca il 
prodotto per il control- 
lo di tre server. 



ver, o il controller del dominio. Tutti 
questi sono servizi essenziali. Il man- 
cato funzionamento potrebbe provo- 
care dei danni notevoli alla rete azien- 
dale che servono. Per tale motivo è 
importante in caso di malfunziona- 
mento che vengano automaticamente 
allertati tutti coloro che a qualsiasi 
titolo possono ripristinare il servizio. 
Questa seconda importante parte, ov- 
vero il notify può essere svolta da GFI 
Network Server Monitor con varie 
modalità. Una particolarmente inte- 
ressante è quella relativa all'invio di 
un SMS di allerta. 
L'ultimo punto su cui vogliamo porre 



l'accento è quello relativo all'estra- 
neità di GFI Network Server rispetto 
alla piattaforma di esecuzione dei ser- 
vizi. Nonostante l'applicativo giri su 
piattaforma Windows, può facilmente 
controllare infatti un server web ope- 
rante su piattaforma Suse Linux. La 
Semplicità con cui queste operazioni 
possono essere svolte è sbalorditiva. 



GFI Network Server 
Monitor 6 

Produttore: GFI 

Sito web: httD://www.afi.com 



Prezzo: dai 425 € -1750 € a seconda 
del numero di server da monitorare 



MONITORIAMO I SERVIZI 



Tre semplici passi che illu- 
strano come aggiungere 
un nuovo server da moni- 



torare. Al termine di que- 
sto wizard dovrete inserire 
l'indirizzo IP del server nel- 



l'apposita maschera, e 
dare il via all'esecuzione 
dei controlli. Il resto lo 



farà il Network Server Mo- 
nitor, eseguendo i check 
sui servizi desiderati. 
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□ Per iniziare utilizziamo il "Quick 
Start Wizard" che ci consentirà di 
aggiungere al nostro pool di server da 
monitorare una nuova macchina, con 
pochi colpi di mouse 



B Scegliamo la piattaforma di riferi- 
mento su cui il server gira. Tra le 
numerose opzioni disponibili scegliamo 
una "Redhat" linux su cui ipotizziamo 
giri un server web 
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B Individuiamo i servizi da monito- 
rare, scegliendoli dalla lunga lista 
che il wizard ci mette a disposizione. 
Possiamo scegliere ovviamente seletti- 
vamente cosa controllare 
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Sezioni critiche 

L'effettiva realizzazione dei costrutti di base, come fork e join 
oppure cobegin e coend, per l'attuazione della programmazione 
concorrente, si scontra con reali problemi tecnici. Vediamo quali 




n 




REQUISITI 



■mutimi; 



rf~?\ Basidi 

. '—* ) programmazione 



Questa volta parleremo delle relazioni che in- 
tercorrono fra produttore e consumatore. 
Non abbiate timore, non stiamo per con- 
durvi nei meandri di una discussione socio-politico- 
economica. Come sempre vi parleremo, invece, di 
un problema reale, che avviene nei sistemi operativi 
quando i processi condividono fra loro una qualche 
risorsa o sono concatenati da una relazione. 



PRODUTTORE 

E CONSUMATORE 

Iniziamo da un esempio che renda abbastanza sem- 
plice la comprensione del nostro problema. È abba- 
stanza frequente che in un processo che coinvolge il 
Sistema Operativo esistano due attori un produttore 
ed un consumatore. Il primo produce risorse, il 
secondo le consuma. Un driver di stampa produce 
caratteri, una stampante consuma i caratteri, di fat- 
to li usa per stamparli. Un compilatore produce co- 
dice oggetto che viene consumato da un assembla- 
tore. Ancora lo stesso assemblatore produce moduli 
caricabili consumati da un loader. 
Permettere al produttore e al consumatore un'ese- 
cuzione concorrente che aumenterebbe sensibil- 
mente la produttività del sistema. Si tratta di accop- 
piare due elementi in modo che siano in grado di 
comunicare. La possibilità di sincronizzarli sulla 




cadenza di un clock non è molto efficiente, giacché 
il consumatore è fortemente dipendente dall'attività 
del produttore. Agisce soltanto quando rileva delle 
produzioni. Inoltre, bisogna garantire ai due uguali 
velocità. Un buffer potrebbe risolvere questo proble- 
ma. Si tratta di un'area di memoria, dove andare a 
riportare i dati prodotti e prelevarli per consumarli. 
In questo meccanismo si rileva il limite per il pro- 
duttore di agire solo quando il buffer è vuoto. Mentre 
per il consumatore di azionarsi solo quando il buffer 
è pieno. Una soluzione plausibile adotta un cosid- 
detto array circolare, che associato alla presenza di 
due indici: in e out, da usare rispettivamente per il 
produttore e consumatore risolve il problema prece- 
dente. Sebbene non si abbia adesso il limite di atten- 
dere che il buffer sia completamente pieno o vuoto, 
si riscontra comunque il vincolo dettato dalla lun- 
ghezza del buffer. 



LE MANI NEL CODICE 

Passiamo all'implementazione. Abbozziamo inizial- 
mente una plausibile struttura dati per il buffer a 
struttura circolare. 



const n = 100; 


type elemento= ...; 


var buffer: array [0..n- 


1] 


of 


elemento; 


in,out,ndat:0 .. n 


-1 






dp,dc:elemento; 



La variabile ndat indica il numero di elementi che in 
un generico istante contiene il buffer. Inizialmente 
le tre variabili in, out e ndat valgono zero. Sviluppia- 
mo adesso le due routine per produttore e consu- 
matore. Esse non saranno altro che due cicli infiniti. 
Il produttore continuerà all'infinito a produrre ele- 
menti processati dal consumatore. 



Tempo di realizzazione 



Fig. 1: Buffer circolare per il problema del produttore 
e consumatore 



(* Produttore *) 


repeat 




< produco 


il dato 


dp 


> 








while ndat= 


= n do; 


(* 


se il buffer è 
attende con 


pino 
un 


oop*) 
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buffer[in]:=dp; 



in: = (in + l) mod n; 



ndat: = ndat+l; 



until false; 



(* Consumatore *) 



repeat 



while ndat=0 do; (* se il buffer è pino 

attende con un loop*) 



dc:=buffer[out]; 



out: = (out+l) mod n; 



ndat: = ndat-l; 



<consumo il dato do 



until false; 

Il comportamento delle due routine è di facile com- 
prensione. Il produttore dopo aver prodotto il dato 

10 consegna al buffer solo nel caso in cui questo non 
sia pieno. Questa ultima operazione si realizza con- 
trollando che l'apposito contatore ndat non abbia 
raggiunto la capacità massima n. Successivamente, 
al fine di incrementare l'indice di riferimento per il 
consumatore in, si usa l'operazione di resto mod 
proprio per tenere conto della circolarità del buffer. 
Infatti, se l'indice avesse sforato di uno la capacità 
massima n-1, applicando l'operazione mod si ga- 
rantisce che questi riparta da zero. Ovviamente, al 
termine si incrementa il contatore dei dati del buffer. 

11 processo del consumatore funziona in modo spe- 
culare. 



CE UHI PROBLEMA, 
BISOGNA SUPERARLO 

Sebbene le due procedure funzionino correttamen- 
te per una esecuzione separata, esse potrebbero 
provocare dei problemi per il caso concorrente. Ve- 
diamo come. Preannuncio che l'operazione che 
provoca dei problemi è proprio l'incremento della 
variabile ndat. Per comprenderne motivo è neces- 
sario verificare l'espansione di tale istruzione in lin- 
guaggio macchina. Ecco come si implementa in as- 
sembler: 

load ri, m(100) 

incr ri 

store m(100),rl 

Analogamente per decremento: 

load ri, m(100) 

decr ri 

store m(100),rl 

Con ri un registro della cpu e m(100) l'indirizzo di 
memoria, per ipotesi 100, dove è contenuta la varia- 
bile ndat. Se il processo può essere in qualsiasi mo- 



mento interrotto si possono ottenere degli effetti in- 
desiderati. Supponiamo che per sei distinti e se- 
quenziali istanti di tempo si eseguano le seguenti sei 
istruzioni macchina. 

Viene riportato in tabella 1 il contenuto dei registri e 
delle locazioni di memoria sensibili. Supponiamo 
che inizialmente la variabile ndat corrispondente 
alla locazione m(100) valga 5. 




(to 




produttore esegue 


load ri, m(100) 


ri vale 5 


~ 


ti 




produttore esegue 


incr ri 


ri vale 6 


interruzione 


t2 




consumatore esegue 


loadrl, m(100) 


ri vale 5 




t3 




consumatore esegue 


decr ri 


ri vale 4 


interruzione 


t4 




produttore esegue 


store m(l 00), ri 


ndafvale4 




t5 




consumatore esegue 


store m(100), ri 


ndafvale4 




^Tabella /.- // flusso delle istruzioni relative al programma di esempio 



Si nota come dopo aver eseguito le prime due istru- 
zioni assembler, corrispondenti all'incremento per il 
produttore, un'interruzione passa il controllo al pro- 
cesso consumatore. Nell'istante t2 però sebbene il 
processo produttore abbia incrementato il registro 
ri, questo non è stato ancora memorizzato. Così, se 
avviene una seconda interruzione, dopo l'istante t3 
le finali istruzioni assembler di store riprendono va- 
lori non corretti. Infatti, ci aspettammo, dopo un'o- 
perazione di produzione e una di consumo, ossia un 
incremento e un decremento, una valore uguale a 
quello iniziale. Purtroppo ndat non risulta 5 bensì 4. 
Il risultato è comunque sbagliato se nell'espansione 
assembler anziché usare un solo registro per di due 
processi il compilatore si servisse di due distinti regi- 
stri. Si deduce che si arriva ad un risultato scorretto 
se si consente di manipolare concorrentemente l'i- 
struzione di incremento o decremento. In definitiva 
si devono attuare delle correzioni per superare l'ef- 
fetto indesiderato. Ad ogni modo è evidente la viola- 
zione delle condizioni di Bernestein. 



FORMALIZZAZIONE 
DELLE ESIGENZE 

Focalizziamo l'attenzione su un insieme di processi 
cooperanti Pi, P2, .. Pn. Ognuno di essi ha un seg- 
mento di codice chiamato sezione critica o regione 
critica, porzione di codice condivisa. Qui ogni pro- 
cesso condivide variabili. Non permettendo l'acces- 
so a tale sezione ai rimanenti processi si evitano 
errori del tipo sopra descritti. L'accesso alla sezione 
critica deve essere garantito nel tempo in modalità 
mutuamente esclusiva. Ovviamente, al più un pro- 
cesso deve essere all'interno dell'area. Il protocollo 
di uso di tale sezione è fatto in modo che un proces- 
so richieda l'utilizzo della sezione critica. Una volta 
entrato svolge le mansioni relative in modo che nes- 
sun altro processo entri. Alla fine del processo si rila- 
scia l'area. Il codice che resta da eseguire è la parte 
rimanente. Ecco come per ogni processo può essere 




I TUOI APPUNTI 



Utilizza questo spazio per 
le tue annotazioni 



CONDIZIONI 
DI BERNESTEIN 

Due istruzioni S1 e 52 
sono eseguibili in mo- 
do concorrente se se- 
guono le condizioni di 
Bernstein: 



1. R(S1) intersezione 
W(S2) = 

2. W(S1) intersezione 
R(S2) = {} 

3. W(S1) intersezione 
W(S2) = {} 

R è l'insieme di input, 
1/1/ è l'insieme di 
outout. 
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DAL PROGRAMMA 
AL PROCESSO 

Fork e join e cobegin e 

coend producono nuovi 

processi. Bisogna quindi 

distinguere i due 

elementi. Un processo 

sequenziale in prima 

istanza è definito come 

l'esecuzione di un 

programma. Il 

programma è un'entità 

passiva, il processo è 

attiva. 




formalizzata la sequenza di azioni: 

(* generico processo che richiede, usa e libera una 

regione critica*) 
repeat 

<sessione di entrata> 

<regione critica> 

<sessione di uscita> 

<codice rimanente> 
until false 

La soluzione deve soddisfare le seguenti richieste: 

• Mutua esclusione: se un processo è nella regio- 
ne critica allora nessun altro processo è in tale 
sezione; 

• Se non ci sono processi in esecuzione nella re- 
gione critica e altri processi ne fanno esplicita ri- 
chiesta, allora uno di essi deve entrare. La deci- 
sione non può spettare ai processi che si trovano 
nella parte rimanente. Inoltre, non si può posti- 
cipare indefinitamente nel tempo tale decisione. 

• Attesa limitata: deve esistere un limite superiore 
di numeri di processi che entrino nella regione 
critica prima di un generico processo. Ogni qual 
volta si utilizza tale strumento bisogna verificare 
che siano soddisfatti i sopraccitati vincoli. 



LBERO DEI PROCESSI E LA LORO GESTIONE 



E utile ricordare che un processo 
può generare un altro processo. 
Ad esempio il costrutto fork che 
attua la programmazione con- 
corrente genera per il processo 
Pi un altro processo Pj. 
Il processo di creazione e dipen- 
denza tra processi può essere 
espresso da un grafo dei proces- 
si. Quando un processo crea un 
nuovo processo si possono at- 
tuare alcune implementazioni: 

• Il padre continua a 
eseguire concorrentemente con 
il figlio; 

• Il padre attende la ter- 
minazione del processo figlio; 

• Il padre è il figlio condividono 
le stesse variabili; 

• Il figlio condivide con il padre 
solo un sottoinsieme di variabili 
di questo ultimo. 



I primi due punti riguardano 
l'esecuzione mentre i secondi 
due la condivisione di variabili. 

II sistema operativo deve attua- 
re delle politiche, quindi 
scegliere tra i punti appena de- 
scritti. 



P1 




/ 


\ 




P2 


P3 


\ 


P4 


P5 


P6 



Grafo dei processi. Il nodo che genera 
un altro processo è detto padre. 
Il nodo generato è il figlio 



'TO: 


Pi esegue l'istruzione while 
e trova fìag[j] false 




interruzione 


TI: 


Pj esegue l'istruzione while 
e trova flag[i] false 






T2: 


Pj porta flag[j] a true 


entra nella sezione critica 


interruzione 


T3: 


Pi porta flaglj] a true 


entra nella sezione critica 




Tabella 2: a , 



PER TENTATIVI 
TROVIAMO LA GIUSTA 
SOLUZIONE 

Sviluppiamo una serie di esempi per verificare l'ef- 
fettiva garanzia della mutua esclusione per regioni 
critiche. Restringiamo dapprima l'attenzione ad al- 
goritmi che sono applicabili a due soli processi: Pi e 
Pj. Una esecuzione concorrente che richiederà quin- 
di la mutua esclusione è quella che deriva dall'appli- 
cazione ai due processi del costrutto cobegin... 
coend. 



<dichiarazione 


delle 


varia 


bili 


comuni> 


cobegin 


Pi; 


Pj; 


coend; 



Ogni soluzione avrà la struttura proposta nel codice 
(* generico processo che richiede, usa e libera una 
regione critica*). 

Soluzione 1 - Proviamo ad adottare una variabile 
turno che assegni la regione critica. Se turno vale i il 
processo, ottiene la sezione critica altrimenti si 
passa il turno al processo/ 



(* Algoritmo 1*) 


repeat 




(*sessione 


dì entrata*) 




while turno 


<> i do; 




<regione 


critica> 




(*sessione 


dì uscita*) 


turno:=j; 


<codice rimanente> 


until false 



Tale soluzione non funziona. Viene rispettata la mu- 
ta esclusione. Non si garantisce progresso, poiché 
se turno vale j e il processo j sta facendo operazioni 
non inerenti la concorrenza, allora Pi non entrerà 
mai nella regione critica. 

Soluzione 2 - Si introduce il concetto di flag. Se ad 
ogni processo assegniamo una bandierina il proces- 
so la alza quando entra nella sezione critica. L'altro 
processo verifica se la bandierina è alzata nel qual 
caso non entra, flag è un array di booleani. 



(* Algoritmo 2*) 


repeat 




while fi 


ag[j] 


do; 




flag[i]: = 


true; 




< regione critica > 




flag[i]: = 


false 






<codice 


rimanente> 


until fai 


5e 







Verifichiamo attraverso un esempio se sono verifica- 
ti tutti i vincoli. Supponiamo che inizialmente i due 
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flag siano entrambi falsi. Inizialmente si attende che 
il processo j liberi la sezione critica. Quando alza la 
bandierina entriamo. La prima azione di Pi è alzare 
la propria di bandierina. Poi occupa la regione criti- 
ca. Al termine si abbassa il flag. Purtroppo siamo co- 
stretti a scartare anche questa di soluzione. Non vie- 
ne assicurata la mutua esclusione. Analizziamo il ca- 
so limite che lo dimostra. Consideriamo la seguente 
sequenza di eventi per istanti di tempo consecutivi, 
Tabella 2. Il fatto che arrivi una interruzione prima 
che Pj stia per alzare la bandierina fa sì che tutte e 
due i flag possano essere trite. Si viola il vincolo sulla 
mutua esclusione. Entrambe i processi possono en- 
trare nella sezione critica. L'algoritmo è dipendente 
dal timing dei due processi. 

Soluzione 3 - Per risolvere il problema prima espo- 
sto si tenta la soluzione di alzare subito la bandieri- 
na. Ecco come si procede: 



(* Algoritmo 3*) 


repeat 


flag[i]:= 


=true; 


while flag[j] do; 


<regione critica> 


flag[i]: = 


= false 


<codice 


rimanente> 


until false 



Abbiamo aggiustato un guasto ma ne abbiamo ge- 
nerato uno nuovo. La mutua esclusione è assicurata 
grazie al settaggio immediato del flag che avviene 
ancora prima che il ciclo while si avvìi. Non è garan- 
tito il progresso poiché, se avvenisse un'interruzione 
subito dopo l'alzata della bandierina, si otterrebbe il 
seguente caso limite di malfunzionamento. 

TO: Pi porta flag[i] a true interruzione 
TI: Pj porta flag[j] a true 

Si innescano per i due processi due cicli infiniti che 
lasciano in loop l'intero sistema. 
Soluzione 4 - Si ottiene finalmente un risultato fun- 
zionante se si mescolano i metodi fino ad ora analiz- 
zati. Questa è la soluzione di Peterson, un vero 
esperto nell'ambito dei sistemi operativi. 



(* Algoritmo 4*) 


repeat 


flag[l]:< 


=true; 




turno: =j; 


while ( f 1 a g [ j ] and turno: 


=j) do; 


<regione critica> 


flag[i]: = 


'false 




<codice 


rimanente> 


until false 



Per entrare nella sezione critica devono verificarsi si- 
multaneamente due condizioni. Il flag e il turno de- 



vono essere associati a valori opportuni per pro- 
cesso. Entrambe le variabili vengono assegnate fuori 
dal ciclo. La garanzia della mutua esclusione, anche 
in presenza di una sequenza sfavorevole di interru- 
zioni, è dovuta alla variabile turno. Questa non può 
valere contemporaneamente due valori diversi, co- 
sicché al più un processo occuperà la regione critica. 
Anche il progresso è garantito. Per tale vincolo il 
punto critico è il while. Qui possono verificarsi due 
situazioni. La prima è che Pi vuole entrare e Pj no, in 
tal caso si può notare come Pi entri. La seconda è 
che si abbia più di una richiesta di entrata. Un solo 
processo entrerà certamente nella sezione critica 
così come descritto per il caso precedente della mu- 
tua esclusione. 

Soluzione 5 - La generalizzazione a n processi fa 
riferimento proprio alla soluzione appena trovata. 
Questa volta il flag potrà valere uno tra tre diversi 
stati: inattivo (inat), pronto a entrare (pe), nella re- 
gione critica (nrc). Per completezza di trattazione il 
codice è presentato di seguito. 

repeat 
repeat 

flag[i]:=pe; 



j:=turno; 



while ioj do 



if flag[j]oinat 



then j:=turno; 



else j: = (j+l)mod n; 



flag[i]:=nrc; 



]:=0; 



while (j<n) and (j = i or flag[j]oncr) do 



j:=j+l; 



until (j> = n) and (turno=i or flag[turno] = inat); 



<regione critica> 



j: = (turno+l) mod n; 



while (flag[j] = inat) do 



j: = (j+l) mod n; 



turno:=j; 



flag[i]: = inat; 



<parte rimanente> 



until false; 



Esistono anche altre soluzioni per la risoluzione del 
problema. 



CONCLUSIONI 

L'analisi approfondita della programmazione con- 
corrente svela appieno le sue difficoltà di sviluppo 
ma anche i molteplici aspetti di interesse. Il viaggio 
alla scoperta di questo ambito continua tra queste 
pagine. Esplorando algoritmo, dopo algoritmo avre- 
mo la possibilità di avere una visione più completa 
sui sistemi operativi. 

Fabio Grimaldi 




TERMINAZIONE 
DI PROCESSI UNIX 

Un processo termina na- 
turalmente quando ha 
eseguito tutte le istru- 
zione. Ad ogni modo 
esistono altri casi in cui 
un processo padre è co- 
stretto a "uccidere" un 
processo figli. In Unix si 
tratta di lanciare il co- 
mando kill id; dove id è 
l'identificativo del pro- 
cesso de eliminare (uc- 
cidere). Ad esempio as- 
sociato al lancio di una 
fork. L'esigenza di elimi- 
nare un processo in mo- 
do non naturale può 
scaturire da due ragioni: 

• Quando il processo 
non svolge attività; 

• Quando il processo ec- 
cede nell'uso di alcune 
risorse, provocando di 
fatto instabilità nel si- 
stema. 

Esiste anche un altro ca- 
so in cui un processo 
viene ucciso. Quando il 
processo padre o co- 
munque un processo ad 
un livello più alto è eli- 
minato. Si parla in que- 
sto caso di terminazione 
a cascata. 
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ON LINE 



« 



SOURCEFORGE 

Istituzionale. Il sito principe per la con- 
sultazione e la creazione di progetti 
OpenSource. È stato il primo a fornire 
la possibilità di aprire un CVS (Mine, 
dove per CVS si intende un sistema di 
upload e revisione del codice che ga- 
rantisce la condivisione delle risorse. 
http://www.sourceforge.net 
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GOTDOTNET 

L'antagonista. La forza dirompente 
dell'OpenSource sta dimostrando 
nel tempo di essere un motore per 
l'evoluzione dell'informatica in generale 
e del segmento programmazione in ge- 
nerale. Cosi' è nato GotDotNet, si trat- 
ta anche in questo caso di un sistema 
che mette in grado i programmatori di 
riunirsi in gruppi e rendere disponibi- 
le il loro lavoro tramite una 
piattaforma ci CVS. 
http://www.gotdotnet.com/ 
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FREEVBCODE 

~ uello più nuovo. Si tratta di un si- 
to appartenente al circuito 
DevX.com il che è già di per se garan- 
zia di qualità. Al suo interno trovano 
posto centinaia di progetti e di snip- 
pet di codice relativo al Visual Basic. 
http://www.freevbcode.com/ 
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APACHE 
COOKBOOK 

Che Apache sia uno dei server 
Web più diffuso al mondo è or- 
mai noto. Nonostante l'agguerrita 
concorrenza dei rivali, la sua diffusione 
è tale che con buona approssima- 
zione si può dire che Internet e Apa- 
che formano un binomio indissolu- 
bile. Nonostante questo, soltanto 
una minima parte delle potenzialità 
di Apache vengono sfruttate dai si- 
stemisti. 

Si tratta infatti di un sistema com- 
plesso, estendibile per mezzo di mo- 
duli, e molto configurabile. Ci sono 
centinaia di opzioni che se ben co- 
nosciute possono risolvere in modo 
semplice molti dei problemi che nor- 




Apache 
Cookbook 



malmente si incontrano nel mettere 
online un sito Web. Questo libro di 
Ken Koar e Rich Bowen, ha per tito- 
lo "Apache CookBook", volendo tra- 
durre letteralmente in italiano suo- 
nerebbe come qualcosa del genere 



"Ricette pronte per usare Apache". 
Si tratta insomma di un libro molto pra- 
tico, e dobbiamo dire, anche molto 
ben scritto, comprensibile a qualsia- 
si livello che mostra all'utente le di- 
verse opzioni possibili per una buo- 
na configurazione del web server. 
Non possiamo dire che si tratti di un 
libro indispensabile, tuttavia leg- 
gendolo si ha la sensazione che mol- 
te cose che prima potevano sembra- 
re "oscure" trovano invece una pre- 
cisa collocazione. 
Difficoltà: Bassa • Ken Koar & 
Rich Bowen • Editore: Mops • 
ISBN: 88-481 -1652-3 «Anno di 
pubblicazione: 2004 
Lingua: Italiana • Pagine: 238 • 
Prezzo: € 29,90 



PROGRAMMARE 

CONIL.NET 

FRAMEWORK 

Se fino a qualche tempo fa si po- 
teva dire che C# era un linguag- 




PBOGR AMIVI ARE 
con il .NET Frsmework 
Linguaggio C#j 
Applicazioni Windows, 
Collezioni di dati 




Volume 1 






gio emergente, adesso si può dire 
che si tratta di un linguaggio con- 
solidato. Alle sue spalle il .NETFra- 
meWork se pur con tante difficoltà 
comincia a diventare un punto di ri- 
ferimento per moltissimi program- 
matori. Imparare C# è una buona 
idea per chi vuole avvicinarsi al mon- 
do della programmazione. Questo 
libro introduce ai concetti base del 
mondo . NET illustrando l'idea di 
programmazione ad oggetti, per poi 
addentrarsi nella costruzione di ap- 
plicazioni Windows, console e ov- 
viamente Web. Il libro inizia abba- 
stanza dalle basi, consentendo a chi 
legge un immersione graduali nei 
concetti della programmazione C#, 



si passa da una parte propedeutica 
alla programmazione utilizzando i 
soli strumenti grafici, ovvero la GUI 
per poi continuare addentrandosi 
nei dettagli e mostrando gli aspet- 
ti più tecnici del .NET framework. 
Nel complesso un buon libro, utile 
a chi si avvicina o si vuole avvicina- 
re a questo genere di programma- 
zione. La nazionalità italiana degli 
autori garantisce una buona fruibi- 
lità della scrittura. 
Difficoltà: Bassa • Autore: Stefa- 
no Del Furia, Paolo Meozzi • Edito- 
re: Mondadori Informatica • ISBN: 
88-04-53606-3 • Anno di pubbli- 
cazione: 2004 • Lingua: Italiana 
• Pagine: 381 • Prezzo: € 14,80 



LABORATORIO 

VISUAL 

BASIC.NET 

Buona parte degli sforzi di Micro- 
soft dell'ultimo anno tendono a 
facilitare il passaggio degli svilup- 
patori da Visual Basic a Visual Ba- 
sic.NET II libro di Romano Gallifuoco 
va nella direzione di fornire un manuale 
pratico all'apprendimento delle nuo- 
ve tecnologie. La praticità del libro si 
riscontra nell'elevato numero di esem- 
pi e nella quantità di esercizi, la vo- 
lontà è quello di semplificare l'ap- 
prendimento di nozioni teoriche mo- 
strando come queste trovino sempre 




un riscontro nella risoluzione di pro- 
blemi pratici. Si parte delle basi, illu- 
strando i controlli del framework .NET, 



si passa attraverso la programma- 
zione ad oggetti per poi arrivare alla 
trattazione di temi corposi, quali lo 
sviluppo di Web Services e la pro- 
grammazione della GDI. 
Senza dubbio si tratta di un libro da 
non perdere, uno di quelli che con- 
viene avere sempre a portata di ma- 
no nella propria libreria, o meglio ac- 
canto al computer mentre si sviluppa. 
Difficoltà: Bassa • Autore:Roma 
no Gallifuoco • Editore: Hops • 
ISBN: 88-503-2105-8 «Annodi 
pubblicazione: 2003 • Lingua: 
Italiana • Pagine: 376 • Prezzo: 
€ 21,00 
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